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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


e all had to start somewhere. I started with 
a lovely ZX Spectrum, then an adorable C64, 
and finally an amazing Amiga. 
These computers weren’t retro when I got 
them. They were cutting-edge, well-engineered 
masterpieces packing state-of-the-art technology. 
Just like the Raspberry Pi today. 
But a Raspberry Pi can become a ZX Spectrum, or 
a C64, or an Amiga, or an Acorn BBC Micro or Apple IJ. 
But why bother when you’ve got all that processing 
power at your fingertips? After all, a Spectrum 
couldn’t run a modern masterpiece like Minecraft. 
Nostalgia plays a part. But there’s still a lot to SUB SCRIBE 
learn from classic computers. The nascent computer 
hardware of the 1980s is, in many ways, easier to = : Ng 
understand that the modern technology stack. SEE PAGE 30 FOR DETAILS : 
There’s something wonderfully glorious about 
revisiting classic computers with a Raspberry Pi. It’s 
the best of the old and the new working together 


in perfect harmony. THIS MONTH: 
This is the second edition of this magazine. We 


heard from readers who had electrical safety concerns 


about a tutorial called ‘Make a WiFi Desk Lamp’. It 16 RETRO COMPUTING 


Emulation and classic coding with Raspberry Pi 


YOUR OFFICIAL 


didn’t meet our standards and, because of the nature 
of the guide, we decided to remove it from circulation. 

We would like to thank the readers who brought 34 PI HEARING AID 
this to our attention. We are a community magazine 
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PROJECT 


irefox maker Mozilla has 
launched a new, open 
standard for IoT and 


smart homes called Project Things. 


Mozilla announced that Project 
Things “makes it easy for anyone 
with a Raspberry Pi to build their 
own Things Gateway [to control 
any kind of smart device] directly 
from the web.” 

We asked Ben Francis, Mozilla 


software engineer, for more detail. 


“The Things Gateway is designed 


Turn On 7 


e Zigbee Smart Phig ts on then turn Z-Wave Smart Plug on 


to bridge existing smart home 
protocols and devices to the ‘Web 
of Things’ using ‘adapters’,” 

he says, to add extra wireless 
protocols to the Pi. 

Ben confirms, “The latest 
version has built-in adapters for 
the Zigbee and Z-Wave protocols 
[as well as] adaptor add-ons for 
devices from brands like Philips 
and TP-Link... We’re calling on 
the community to help us builda 
whole directory of add-ons.” 


Use the simple web interface to control all your smart devices 
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Many smart home devices use 
Zigbee or Z-Wave to minimise 
power draw. However, as few 
smartphones have Zigbee or 
Z-Wave hardware, smart home 
apps have to relay information 
via a physical hub unit. These 
hubs tend to be proprietary, 
closed ‘black boxes’ - even worse, 
you might need one for your 
lights, another for your heating 
system, and yet another for your 
multi-room speakers. 

Ben says that Project Things 
aims to “standardise web 
technologies as acommon layer”, 
thus consolidating the need 
for hubs into one open-source, 
customisable and upgradable, 
Raspberry Pi-powered unit. 


Beyond the black box 
Any smart device should be 
compatible with a Things Gateway, 
as Ben clarifies: “Our goal is not 

to create a proprietary Mozilla loT 
platform, but rather help to build 
a World Wide Web of things, much 
like the World Wide Web of pages 
you can browse with Firefox.” 
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Things Gateway 


Web Thing API 
(HTTPS+WSS) 


Serial 


os ? 


Ben expounds that by “using the Ben adds that “working towards 
Web Thing Description format and royalty free IoT standards, 
Web Thing API (iot.mozilla.org/wot) with multiple competing 


loT 


we’re contributing towards implementations, should help to 

soe P “ee . Above Project Things uses open- 
standardising through the World drive down the certification and couircestandards to bring together 
Wide Web Consortium (W3C).” licensing costs, [both for hardware — competing smart home standards 


To build a World Wide Web 
of things, much like the 
World Wide Web of pages 


THE FUTURE OF PROJECT THINGS 


Project Things was only announced in June 2017, 
so to have working code already just seven 
months later is pretty impressive. But Mozilla isn't 


Interestingly, given Mozilla’s devices and] the software needed stopping there. 
web-based background, Ben to connect them together.” Mozilla software engineer Ben Francis explains, 
confirms that “the rules engine The Project Things GitHub page “The Things Gateway is one part of a framework of 
built into the Things Gateway runs is live (github.com/mozilla-iot) software and services from Mozilla to help create 
locally on the home network.” and you can start making your greater interoperability, privacy, and security on 
Further, “Mozilla provides asecure Things Gateway at iot.mozilla.org. the Internet of Things.” 
tunnelling service to make it safe Mozilla recommends a Raspberry Ben even gave some details of the kinds 
and easy to access the gateway over Pi3, and afew USB dongles to add of thing we can expect as part of the Project 
the internet.” support for Zigbee and Z-Wave. Things framework: “We also plan to provide 


a collection of loT cloud services (starting 

with the secure cloud tunnelling service) and 

a device framework which provides reusable 
software libraries for platforms like Arduino and 
Android Things.” 

The aim is to allow developers to create 
“native web things which connect to the Web of 
Things directly.” 

With open-source software, combined with 
cheap and well-supported hardware such as the 
Raspberry Pi and Arduino boards, Project Things 
could finally bring some harmony to the confusion 
of conflicting smart home standards. 
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Kenneth O'Halloran, Coolest Projects 2017 


COMES TO THE UK 


_ CoderDojo event expands 


Coolest Projects is an There's plenty to do 
international event for young at Coolest Projects, besides 
digital makers aged 18 and under demonstrate your own build 


n international show for 

young digital makers 

to demonstrate their 
projects, CoderDojo’s Coolest 
Projects is coming to the UK for the 
first time this year. 

Coolest Projects International 
will take place at the Royal 
Dublin Society on Saturday 26 
May (coolestprojects.org), while 
Coolest Projects UK is on Saturday 
28 April, at Here East in the 
Queen Elizabeth Olympic Park, 
London (hereeast.com). 

Anyone under the age of 18 and 
currently in primary, secondary or 
further education can enter, either 
as an individual or part of a team 
of up to five members. Projects are 
entered into five broad categories: 
Scratch, Websites, Games + 
Web Games, Mobile Apps, and 
Hardware. The full criteria for each 
are at magpi.cc/2CPqaK5. 

Rosa Langhammer, CoderDojo 
General Manager, Outreach & 
Engagement, explains: “Coolest 
Projects is about bringing an idea 
and sharing it with your peers, no 
matter how big or small or even 
if your project isn’t finished.” 

The entry categories are so 
broad because CoderDojo wants 


“Coolest Projects to be as inclusive 
as possible.” 


Inspiration across 

the nations 

Coolest Projects started “in 2012 
with 19 projects,” Rosa confirms. 
Now Coolest Projects is “an 
international showcase with 

750 young people participating 
last year from 16 countries!” 

Each participant will have their 
own area to set up their project, 
and will “have some free time 
throughout the day to explore other 
projects, as well as some of the cool 
demos and speakers that will be 
joining us for the day,” says Rosa. 

“It’s really important to have 
hands-on activities scattered 
throughout,” Rosa continues, 

“so parents, young people, and 
the general public can get hands 
on with science, technology, and 
the arts.” 

Rosa’s favourite Coolest Project 
came from 12-year-old Amy, 
who created a smart beehive 
“with a mission to save bees!” 
Amy uploaded data from her 
hive to hivetool.net, helping 
“international scientists to 
understand why bees are dying.” 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 


and features lets you code less and do more. 


Free download on 


CDP Technologies AS Tel: +47 990 80 900 
Nedre Strandgate 29 info@cdptech.com 
P.O. Box 144 www.cdpstudio.com 
NO-6001 Alesund, Norway 


CDPStudio 


PI-MADE 


MUSIC 
ALBUM 


NOW That’s What I Call Chiptune! 


emoscene musician 
Yerzmyey has created an 
entire music album on 
a humble Raspberry Pi 2, called 
RPI Zwei. 

Yerzmyey’s music is as full and 
complex as any track you’d hear on 
the radio or Spotify. Yerzmyey tells 
us that “The most complex song 
on the album has 26 independent 


channels of digi-music” and 
even says the Pi “could surely 
manage more.” 

As Yerzmyey explains, the Pi 
doesn’t have a DAC (a digital-to- 
analogue converter) so instead 
you have to record music on 
the processor itself. This limits 
the audio to 11-bit, 40 MHz, but 
that doesn’t seem to have held 
Yerzmyey back. 

Having first started creating 
‘demoscene’ music ona 


Yerzmyey blowing out beats in Tokyo in 2014 


ZX Spectrum in the 1980s, 
Yerzmyey used MilkyTracker 
(magpi.cc/2C2HqhH) to 
“program all [the] notes one- 
by-one... Otherwise I use loops 
only when it comes to drum ‘n’ 
bass” and instruments such as 
guitar. Layering notes and loops, 
Yerzmyey “composed the music 
on the Pi and then recorded it all 
directly from the ‘jack’ output.” 
You can listen to RPI Zwei here: 
magpi.cc/2DC1Ym5. 


PI-FRIENDLY 


10.1’ TOUCHSCREE 


IPS tech for iPad visuals 


eading-based electronics specialist 

supplier Inelco Hunter has launched a 

new touchscreen, designed for Raspberry 
Pi. The screen has a 1366x768 resolution and uses 
IPS technology. 

The use of IPS technology over the cheaper TN offers 
“a wider view angle and the full 16.7 million colours,” 
says Inelco Hunter managing director David Bushnell. 

David tells us that demand is for wide viewing 
angles and higher definition; IPS technology also 
offers “a better contrast ratio” and so delivers 
stronger, punchier colours. 

The 10.1-inch screen “is designed to work with all 
models of the Raspberry Pi,” David confirms, with 
standoff pillars and screws provided. 

The screen “supports Raspbian and NOOBs,” 

says David. “We are working on drivers for the PC 
interface” if you’d rather not use the currently 
supported USB connection. “Once Raspbian 
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A high-quality five-point 
touchscreen for your Pi 
makes for a great control 
panel or kiosk installation 


is installed, the five-point touch will work 
automatically,” David explains. 
The new screen is on sale now, from 
magpi.cc/2C35bX4, but pricing is based on order 
quantity. You can contact Inelco Hunter directly at 
marketing @inelcohunter.co.uk. 
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WORLD'S 
TV STATION 


LimeSDR dongle turns a Raspberry Pi 
into a TV broadcast mast 


The stories we shared 
that flew around the world 


FEREKRRRRERERYY 


ice oe oe ede Pea, 


oftware-defined radio us, “We were delighted to see 

(SDR) enthusiast Evariste Evariste’s system.” Ebrahim adds 

Okcestbon has made that he’s also seen “systems to talk 
possibly the world’s smallest TV to the ISS Space Station, LTE [4G] mpgpl cer er etallva. 
station, using a LimeSDR Mini base stations, [and] IoT platforms.” BitScope partnered with the Los Alamos National 
dongle, a Raspberry Pi Zero, LimeSDR recently released an Laboratory to build a single box containing 750 
and a mini camera module to SDR Starter Kit to make it easy for Raspberry Pi 3s in a cluster configuration 
broadcast a TV signal to a Pi3 with anyone to build similar projects. - that's 3000 processing cores! 
USB TV tuner. The Kit uses Grove connectors for 


We wanted people to be able 
to simply pick one up and play 


Evariste showcases his build on the bundled 15 sensors and inputs, ————s 
YouTube (youtu.be/jo6pCleTIzs), and is programmable in Scratch. 
and then explains his setup, which Ebrahim explains, “We wanted 
gets quite technical. people to be able to simply pick one 
Ebrahim Bushehri, CEO of up and play.” 
Lime Microsystems (maker of The Starter Kit costs $249 from : 
the LimeSDR Mini dongle), tells magpi.cc/2BZp6WF. MaQpHeececiMees 


For those who don't have the confidence, kit, or time 
to solder a GPIO header to a Raspberry Pi Zero W, 
the organisation has launched the Pi Zero WH - a 

Pi Zero W with pre-soldered header. 


u 


is 


magpi.cc/2COWN1T 


A Raspberry Pi makes for an ideal kiosk PC, but you'll 
need a robust, secure, and dedicated OS to go with 
it - enter Raspberry WebkKiosk 7, now updated to 


Evariste's build might be a bit advanced, but the LimeSDR Starter Kit 
should get you going without any need for soldering or text-based coding Raspbian Stretch. 
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FIGHI-MIC 
MATRIX VOICE BOARD 


With an eight-microphone 
array and on-board audio processing, 
the Matrix Voice is a complete digital 
assistant for your Pi 


Ideal for DIY digital assistant builds 


atrix Voice’s latest IoT 

add-on, the Matrix Voice, 

has been released in the 
UK - via Newark element14, or 
direct from matrix.one. The 
standard circular board (with a 
female header that slots onto the 
Pi’s GPIO pins) costs around £40, 
while the ESP32 version costs 
roughly £45. 
Loaded with eight microphones, 
stereo output (headphone and 3W 
speaker amplifier), plus a ring of 
18 RGBW LEDs, WiFi, Bluetooth 
4.0 LE, and a dual-core Tensilica 
Xtensa processor, the Matrix Voice 
is compatible with all digital voice 
assistant standards, even “on the 
edge services like Pocketsphynx 


The Life Scientific interviews Raspberry Pi co-founder 


aspberry Pi co-founder 

Eben Upton appeared on 

a recent episode of BBC 
Radio 4’s The Life Scientific, to 
discuss the amazing success of the 


Raspberry Pi and how it came to be. 


Host Jim Al-Khalili asked Eben 
how the name ‘Raspberry Pi’ 
came about — it follows the grand 
tradition of naming computers 
after fruit, with Eben even listing 
“Acorn — very technically a fruit” 
among more obvious names such 
as Apple. 
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“Actually,” Eben continued, 
“it?s such a long tradition 
that there aren’t that many 
[fruits] left.” The other part 
of the name comes, Eben says, 
from Python: “Python has 
always been at the heart of 
everything we’ve done because 
it’s a fantastic introductory 
programming language.” 

Eben also detailed the 
serendipitous role that BBC 
technology correspondent Rory 
Cellan-Jones played in the creation 


and Snowboy,” according to 
Matrix Labs CEO and co-founder 
Rodolfo Saccoman. 

“Developing voice-enabled 
IoT products should not only 
be reserved for those with 
multimillion-dollar hardware 
budgets,” Rodolfo tells us. 

“The open-source Matrix 
Voice empowers makers and 
industrial engineers.” 

Rodolfo confirms that the Matrix 
Voice has been tested with the 
Raspberry Pi 3, Zero, and Zero W, 
and that “we provide beamforming 
and direction of arrival methods” 
with the supporting software, 
which is compatible with Raspbian 
and Android Things. 


Above Eben talks about the birth and 
success of the Raspberry Pi on Radio 4 
show The Life Scientific 


of the Raspberry Pi as we know and 
love it today. 

You can listen to the whole 
program on the BBC Radio 4 
website: magpi.cc/2CPZcSA. 
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PYTHON DAY ON THE ISS 


PYTHON 
DAY ON 
THE ISS 


Astro Pi Mission Zero Executes 
1771 Scripts in a day 


ith over 2500 entries to the new Astro Pi Mission 
Zero challenge, over 1771 Python scripts made 


: ; : : Arecent 

it to the International Space station, hurtling infageler 
through space 250 miles above us. Each script was Italian 
executed in series on Thursday 1 February. estieoeur 


: : Paolo Nespoli 
The Mission Zero challenge was to write a Python using one of 


script that showed the astronauts aboard a message et a li 
on the Astro Pi LED matrix while sensing and 

displaying the temperature of their ISS cabin. Each 

script that passed the rigorous scrutiny procedure (you 

can’t just run any old code in space) was guaranteed to 

run on an Astro Pi aboard the ISS for 30 seconds. 


MCP is in control 

Thankfully, each script didn’t need to be launched 
manually. As David Honess, Raspberry Pi Foundation 
education resource engineer, explains, “We have 

a special program called the MCP (master control - 
program); it’s a homage to the 1982 Disney film Tron. G [> [ G O 

This is responsible for running all the programs in O 

sequence and storing the times, ISS locations, and the 20+ new p rojects for your Pj robot car. 
process exit code.” 

The location of the ISS when executing each script is 
important, as each successful applicant will receive a 
certificate showing the location of the ISS when their 
code executed. 

If you want to spot the ISS (it orbits Earth 15 times a 
day), David recommends pointing your web browser to 
Heavens Above: heavens-above.com. 
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LEGO MINDSTORMS + RASPBERRY PI 


The two Astro Pi modules - you can emulate them using the 
Sense HAT emulator, developed in partnership with Trinket 
(trinket.io/mission-zero) 
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pi-top 
Clos 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular Laptop. 


Get started with 20+ inventions in the inventor's 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 
form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based Learning. 


Modular 
Accessories 


Stay up to date with our latest news by following our social media 


ne nf a 


| eee at 


pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating systern) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
learning lesson plans with pi-topCODER and have fun 


learning to code with CEEDuniverse! 


CEEDuniverse 
ey 


pi-topCODER has a fully 
integrated coding environment 
letting you program hardware 
code in Python and Learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, learn problem 
decomposition by solving 
visual programming puzzles. 


RETRO 


peearideste dente 
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RETROCOMPUTING | feature 


veryone we know has their 
E own favourite computer. 
Many of The MagPi team 
still love the Sinclair Spectrum; 
others remain loyal to the 
Commodore 64. 

Eben Upton’s eyes light 
up when he talks about his 
Commodore Amiga. 

It was this experience of classic 
computing that led to the creation 
of the Raspberry Pi. This marvellous 
computer was designed to teach 
young people to program. Back 
in the 1980s, kids had to program 
computers in order to use them. 
Consequently, these kids then grew 
up with an innate understanding of 
how computers work. 

The Raspberry Pi is an 
amazing computer that harks 


You can place the Raspberry Pi 


inside its official case, or fit one 
inside a retro-themed case (or 
even an actual retro computer). 


If you plan to download Lots of 
emulated software, then you 
might need a larger microSD card. 
But 8GB should be plenty to set 
up and test a retro computer. 


O05. MICRO SD CARD 


back to this golden age, and 

it’s capable of emulating the 
very machines that inspired 

it. You can turn a Raspberry Pi 
into a Sinclair Spectrum, ora 
Commodore Amiga, and discover 
(or rediscover) all the classic 
programs, software, and coding 
techniques that kids learnt back 
in the 1980s. 

You can use a Raspberry Pi in 
its original case. Or even put a 
Raspberry Pi inside the case of a 
classic computer. Then you get all 
the love of the original machine, 
with lots of modern features (such 
as HDMI support and networking). 

In this feature we’ll do all of 
that and much more. Get ready to 
go back in time to the golden age 
of computers. 


02. POWERFUL 
PROCESSOR 


The modern ARM processor 
inside a Raspberry Pi is vastly 
more powerful than the chips 
found in older computers. A 
Raspberry Pi can easily emulate 
computers like a Commodore 64 
or Spectrum. 


03. MODERN 
CONNECTIVITY 


A big advantage the Raspberry 
Pi has over older computers 

is Ethernet and wireless 
networking capability. This 


makes it much easier to upload 
files to your retro computer, 
and some hobbyists have even 
created stylised web browsers 
for classic computers. 


04. VIDEO OUT 


Most Raspberry Pi models 
connect to an HDMI television. 
You can also use the 3.5mm 
audio/video jack on a Raspberry 
Pi 2 or 3 (or A+ or B+) to connect 
AV cables to a classic CRT 
(cathode ray tube) television. 


KIT 
YOU'LL 
NEED 


RASPBERRY PI 

We'd recommend using a Raspberry Pi 3 to power 
your emulated computer. But you can use other 
models, like the Pi Zero W. 


HDMI CABLE 

We recommend starting out by hooking your 
Raspberry Pi to an HDMI display using a regular 
cable. This will be easier to set up than going straight 
for a classic CRT option. 


MOUSE & KEYBOARD 

While many older computers didn't use a mouse, 
you'll still need a USB mouse and keyboard to install 
and set up the emulation software. 


RETROPIE IS YOUR ONE-STOP SHOP IF YOU WANT TO EMULATE CLASSIC 
COMPUTERS AND CONSOLES, FROM THE ZX SPECTRUM TO EARLY IBM PCS 


YOULL 
NEED 
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hile you can emulate each provides some functionality it, and use Etcher to copy it toa 

classic computer system in this department. microSD card. 

you fancy separately, A Raspberry Pi Zero is powerful RetroPie is a chunky distro, so 
either using a dedicated bootable enough to smoothly emulate 8-bit you’ll need at least a 4GB card if 
image or a desktop application, computers, but if you want to you want to install a few different 
we’ve picked RetroPie forourmain experiment with moredemanding emulators, and we recommend 
emulation tutorial. software and emulators such as opting for a 32GB SD card to 

It’s not perfect, andin some cases DOSBox, we recommend using leave plenty of room for your 

you’ ll get better results by installing a Raspberry Pi3. software collection. 


emulators individually, but it’s the 


coolest and easiest way togetafeel => STEP-01 >STEP-02 


for the world of emulation. Download and image RetroPie Set up RetroPie 

RetroPie comes with a huge While you can install RetroPie on The first time you boot its SD card, 
selection of pre-installed and top of Raspbian, the ready-made RetroPie will take a few minutes to 
optional emulators for almost RetroPie distro is easier touseand complete its installation procedure 
every computer you can think of, more resource-efficient. Download before handing over control to you. 
with the conspicuous exceptionof the appropriate version for your Pi You’ll be asked to configure 


the BBC Micro, although AdvMAME from magpi.cc/2Eq4H2o0, extract your controllers. You can use a 


RETRO COMPUTING 


CONFIGURING 


KEYBOARD 


keyboard for this, but RetroPie 

is easiest to navigate using a 
joystick or gamepad. Press and 
hold any key on your input device 
of choice to set it up. If you run 
out of buttons, just press and hold 
a key to skip each subsequent 
setting. At the bottom, press the 
button you set as A to complete 
the process. 

If you don’t have a physical 
network connection, your next step 
should be enabling WiFi. You can 
scroll between different emulators 
in RetroPie’s main settings menu 
using the left and right buttons. 

To configure WiFi, move to 
RetroPie menu shortcut (your 
emulator should open on this 
screen) and press button A. Select 
the WiFi option at the bottom of 
the menu. 


>STEP-03 

Add extra emulators 

RetroPie comes preconfigured with 
a number of popular emulators, 
and a few old computers are 
supported out of the box, including 
the ZX Spectrum (via lr-fuse) and 
Amstrad CPC (with Caprice32). 

However, its default set is mostly 
focused on old-school consoles. 

As we’re more interested in classic 
computers than in consoles, you’ll 
want to add a few extras. 

On the RetroPie menu, go to 
RetroPie Setup, then Manage 
packages > Optional packages, 
where you’ll find the original 
version of FUSE (required for 
our Spectrum tutorial on page 
24), DOSBox, Hatari, Vice, and 
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dozens more emulators dedicated 
to everything from arcade 
machines to point-and-click 
adventure games. 

Remember to check the 
operating instructions for each 
emulator at retropie.org.uk/docs. 


>STEP-04 
Find some software 
Most of RetroPie’s emulators 
come fully loaded with the ROM 
(read-only memory) images of the 
computer operating systems you’ll 
be using, but unless you want 
to write all your own programs 
from scratch - which is certainly 
an option - you’ll have to find 
some software. 
There are plenty of websites 
dedicated to sharing new 
and old software for vintage 
computers. Specialist sites such 
as worldofspectrum.org and 
c64.com are packed with programs 
to download for your emulator. 
While a lot of vintage software 
has been placed in the public 
domain or made open-source by 
its creators, ‘abandonware’ has no 
legal meaning and downloading 
no-longer-supported software 
counts as piracy in many countries, 
including the UK. 


>STEP-05 

Boot to the OS 

RetroPie’s default behaviour is 

to boot directly into the software 
you’re trying to run on a given 
emulator, but this isn’t much help 
if you want to access its original 
operating system. 


Left A customisable configurator lets you 
assign input device buttons as needed 


Some of its emulators, like FUSE, 
are installed with a blank file that 
gives you access to its emulated 
Spectrum interface. For others, 
such as the Vice C64 emulator, 
the easiest option is to open the 
Midnight Commander file manager 
from the settings menu, navigate 
to the relevant roms subdirectory 
and create a blank file with the 
appropriate extension. 

For Vice, go to the ~/RetroPie/ 
roms/C64 directory and type 
touch empty.prg. Load from the 
graphical interface and you’ll 
be taken straight to the C64’s 
BASIC interface. 


>STEP-06 

Copy over your files 

The most obvious way to copy 
over your files is to put them 
ona USB stick, plug it into your 
Raspberry Pi, and use Midnight 
Commander, as described above, 
to transfer everything into an 
appropriate directory. 

However, if connected to your 
network, RetroPie also uses 
Samba to share a directory that 
you can copy files to from other 
computers on the network. You 
can also enable the browser- 
based retropie-manager, via the 
experimental package list under 
‘Manage packages’. 


mere  s 
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COMPAR DOM, 


Above RetroPie provides a polished, 
joystick-friendly front end to access 
your emulators and software 
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EMULATORS ARE AVAILABLE FOR 
EVERY RETRO COMPUTER YOU 
CAN THINK OF, BUT NOT ALL OF 
THEM PLAY NICELY WITH THE 
RASPBERRY PI. HERE ARE OUR 
FAVOURITES, WITH A BIT OF EXTRA 
INFO ON HOW TO USE THEM AND 
WHAT TO DO WITH THEM 


20 
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> magpi.cc/2ErcA7S 


The Free Unix Spectrum Emulator 
(FUSE) is one of the longest- 
running and best-supported 
emulator projects around. It’s in 
the Raspbian and Ubuntu MATE 
repositories, so you can install 
it with sudo apt install 
fuse-emulator-sdl. 

Before you get cracking, you’ ll 
want some Spectrum operating 
system ROM files (sudo apt 
install spectrum-roms) and 
utilities (sudo apt install 
fuse-emulator-utils). Press 
F1 to access the menu (and its 
full screen in the options menu, 
needed if you run it from a GUI). 

FUSE opens with a perfect 
emulation of the ZX Spectrum 
BASIC, so you can start 
programming straight away. 
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> magpi.cc/2ErIWiC 


The Apple II was always more 
popular in the USA than in the 
UK, but as an early step on the 
hardware development path 
that led to Apple becoming the 
household name it is today, it 
resulted in the creation of some 
of most influential software ever 
made, particularly games. 
LinApple-Pie provides an 
authentic recreation of the 
Apple II and its implementation 
of BASIC, and is available for 
RetroPie and via GitHub to 
download and compile under any 
Linux-based Raspberry Pi OS. 


Re, POS het, oe, 
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> hatari.tuxfamily.org 


The Atari ST spent much of the 
1980s and 1990s as the arch-rival 


of the Commodore Amiga for 
home computing, the two 16-bit 
computers having superseded 
the primitive-by-comparison 
8-bit machines. In addition, the 
ST’s integrated MIDI ports and 
generous memory (anywhere 
between 512kB and 4MB) saw it 
appearing in music production 
studios across the UK. 

The Hatari emulator supports 
USB MIDI adapters, which means 
you can connect MIDI input 
devices like keyboards and output 
hardware like Roland’s SC-55 
with software such as Cubase 
and Notator. 

You can install Hatari from 
Raspbian’s standard repositories 
(sudo apt install hatari), but 
you’ll need ROM images of Atari’s 
TOS (The Operating System), 
which you can learn about at 
magpi.cc/2Em8Fcv and download 
from magpi.cc/2EstrqE. 


> magpi.cc/2EoKAS3 


The BBC Micro isn’t as well 
supplied with emulators as some 
of its more international rivals, 
but although BeebEm hasn’t been 
updated in over a decade, it’s solid 
and stable. However, compiling it 
involves a couple of extra steps. 
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RETRO COMPUTING 


Download beebem-0.0.13.tar.gz 
and the 64-bit, keys, and 
menu_crash patches. Now: 


sudo apt-get install 
libgtk2.@-dev libsd11.2-dev 
tar -zxvf beebem-0.0.13.tar.gz 


Before you cd into the directory... 


patch -p® < beebem- 

6.0.13 64bit.patch 

patch -p® < beebem-0.0.13- 
keys.patch 

patch -p@ < beebem-@.0.13_ 
menu_crash.patch 


cd beebem-@.0.13 
./configure 
sudo make install 


The emulator comes fully loaded 
with operating system ROMs, 
and you can access its settings by 
pressing F12. 


> magpi.cc/2Erd120 


VICE, the Versatile Commodore 
Emulator, is a fantastically 
authentic emulator that not only 
provides a spot-on reproduction 
of the C64 user experience, but 
also the rest of Commodore’s 
8-bit computer range, including 
the VIC-20 and Plus4. 

To install it under Raspbian, 
enter: sudo apt install vice. 
Once running, you can access 
its menus by pressing F12. A huge 
range of clearly labelled settings 

let you do everything from 
saving programs to connecting 
your emulated computer 

to the internet. 
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> dosbox.com 


Emulating DOS software on a 
Raspberry Pi can be a challenge, 
simply because of the huge 
range in required specifications 
between MS-DOS’s first release in 
1981 to its final iteration in 2000. 
DOSBox is available in the 
Raspbian repositories, so 

you can sudo apt install 
dosbox and consult the 

excellent documentation 
(magpi.cc/2EmbSJ3) to get 

your vintage software mounted 
and installed. 

DOS has the widest imaginable 
range of software, from DTP 
programs and office suites to 
fractal generators and games. 
However, given the Raspberry 
Pi’s limited processor power, 
you’re best off sticking to software 
released before the mid-1990s. 


(‘Gea 


> openmsx.org 


The MSX, with its built-in 
Microsoft eXtended BASIC, 
had near-arcade quality 
games and some of the first 
implementations of the MIDI 
electronic music standard. 


While there are a number 
of good MSX emulators out 
there, OpenMSX is regularly 
updated, extremely faithful, 
and can be found in the standard 
Raspbian repository, so you 
can install it with sudo apt 
install openmsx. 

It even supports MIDI via 
USB adapters and soft synths, 
so you can use the extensive 
range of MSX music utilities 
archived online. 

OpenMSX comes with an open- 
source operating system ROM, 
but this doesn’t include MSX 
BASIC, so you’ll have to hunt 
down original ROM images for 
your MSX before you can write 
your own software. 


> magpi.cc/2ErK2ee 


During the late 1980s, the 
Amiga was known for its huge 
range of games and audiovisual 
demos that pushed the limits 
of what Commodore’s systems 
could achieve. 

AmigaOS is still in development, 
with version 4.1 available to 
buy for around £30, while older 
versions of the sort you’ll want 
for emulation are sold by Cloantro 
(amigaforever.com). 

Amiberry is optimised to get 
the best performance out of the 
Raspberry Pi and is available via 
RetroPie, as a bootable image, 
and as source code. If you compile 
it yourself, follow the First 
Installation instructions to get 
all the dependencies it needs 
in place. 
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DISCOVER ALL THE FUN YOU GAN HAVE 
~ WITH AN EMULATED CLASSIC COMPUTER 


hile playing games and 


home computer world. Electronic 


USBORNE GUIDE TO 


BETTER 
BASIC 


A beginner's guide to writing programs 


Above The Usborne Guide to Better BASIC, 
one of the firm's classic computer books 
now available as a free download 


Image Credit: Usborne Publishing 
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W writing software are the 
most obvious uses for 
your virtual vintage computer, 
using old-school software 
provides a unique look and feel 
to more artistic projects, too. 

Back when IBM PCs had nothing 
more than a buzzing monophonic 
beeper to communicate with 
the world, the Atari ST and 
Commodore Amiga were creating 
fantastic polyphonic synth tunes. 

We’ve already mentioned 
the ST’s integrated MIDI ports 
and popularity as a musician’s 
composition, production, and 
performance tool using software 
such as Cubase. 

At the same time on the Amiga, 
MOD files, first created as a 
native format for the Ultimate 
SoundTracker audio composition 
tool, quickly became ubiquitous, 
and their influence is clearly 
audible in modern chiptune music. 
Freeware ProTracker 3.15 is still a 
popular composition tool. 

The Amiga was also the 
graphical champion of the 16-bit 


Arts’ Deluxe Paint was the art 
program of choice for game 
developers and digital artists 
alike. A powerful bitmap graphics 
tool, it was eventually ported 

to MS-DOS, once PC graphics 
technology caught up, and 
produced the original pixel art for 
classic games like The Secret of 
Monkey Island. 


RENDER 3D GRAPHICS 
If you fancy turning your hand to 
ray-traced graphics, POV-Ray - 
the Persistence of Vision Raytracer 
- is free and provides old versions 
for download, all the way back to 
its 1992 DOS release. You’ll have 
to get to grips with its text-based 
language for defining the 3D 
objects you wish to render and your 
render times on a Raspberry Pi will 
probably take about as long as they 
would have on a 386 back in the day. 
One of our favourites is 3D 
Construction Kit II (also known as 
3D Virtual Studio) for the Atari, 
Amiga, MS-DOS, and even some 
8-bit systems. Based on the 
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This isometric adventure-RPG is a short but lovely 
exploration of a post-apocalyptic world. 
magpi.cc/2Emarub 


HOME OFFICE 


XIASAX (ZEVIMODOKI) (MSX) 


Escape destructive robots in this strategic arcade 
blaster with synthesized voice effects 
magpi.cc/2E7BSZg 
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PROTRACKER 3.15 
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modarchive.org 


3D CONSTRUCTION KIT 
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magpi.cc/2EmjxHj 


uckily, many ZX Spectrums 
have made it to 2018 in 
working order, but the 
ones that weren’t so fortunate 
can find new lives as a keyboard 
and case for the Raspberry Pi. 

A Raspberry Pi Zero W fits 
most easily into a Spectrum 


ZX Spectrum 


REC 


EorrT CAPS LOCK TRVE VIDEO 
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case. There’s space for larger 
models in the raised upper area 
of the case, but the wiring gets 
more complicated. 

Always measure carefully, clean 
everything, double-check all 
positioning, and make sure you 
have enough cable to connect each 


TURN A DEFUNCT ZX SPECTRUM CASE AND MEMBRANE KEYBOARD 
INTO A NEW HOME AND INPUT DEVICE FOR YOUR RASPBERRY PI 


component once everything’s 
in place. 


KEYS TO THE CASTLE 
The Spectrum keyboard uses a 
thin plastic membrane sandwich 
with two layers of electrical 
tracks which form a matrix 
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A Pi Zero is perfect for the shallow 
casing of a classic ZX Spectrum. It 
also allows easy access to HDMI 

and power through the case 


The ZX Spectrum lacks function 
keys, so we use this switch to tell 
the Raspberry Pi to remap the 

number keys to F1, F2, and so on 


We can connect the keyboard 
directly to the GPIO header. You 
can use any available I/O pins, 
but see ‘Ribbon solder guide’ box 
(p27) for our suggested layout 


These connect the keyboard 
membrane to the Raspberry Pi. The 

stripboard provides stability and the 
diodes prevent short circuits 


grid of 5x8 tracks. When a key Cut two pieces of stripboard, one from the address lines doesn’t 


is pressed, it creates a circuit 
between two of these tracks. 
Each key ‘lights up’ a unique pair 
of tracks. 

The tracks lead into two ribbon 
cables that go from the keyboard 
assembly to the motherboard. 


for each connector. Carefully 
work out where to place these 

in the case, as the ribbons from 
the membrane must not be 

put under any stress. Ideally, 
model their positioning on the 
Spectrum’s original motherboard, 


The ribbons are extremely 
delicate and normally the 
first thing to fail on a Speccy 


The ribbon connectors consist 
of five data lines (KB1) and eight 
address lines (KB2). One wire on 
each will light up per key press. 

The ribbons are extremely 
delicate and normally the 
first thing to fail on a Speccy, 
making keys on the broken 
line unresponsive. Newly 
manufactured replacements are 
available if needed. 

The ribbon cables go to two 
connectors, which we’ll need to 
connect them to the Raspberry 
Pi’s GPIO. You can harvest 
these from a dead Spectrum 
motherboard or buy online. 
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using masking tape to mark 
their position. 

Spectrum keyboard connectors 
are very delicate. If required on an 
old one, manipulate the contacts 
carefully so they make a good 
connection with the ribbon. 

Most importantly, make sure 
you solder them into position 
the correct way around! Only one 
side of the ribbon has its contacts 
exposed and these need to match 
up with the flat side of each 
connector. KB1 connects at the 
bottom, KB2 at the top. 

To support multiple key presses, 
we need to ensure that the current 


short-circuit, so a diode is used to 
protect each line. When soldering 
the stripboards, make sure you cut 
the tracks between the resistors 
and the diode. 


FUNCTION KEYS 
You’ll also notice another 
component: a button. The 
Spectrum keyboard lacks function 
keys, but you’re going to need 
them to control the Raspberry Pi. 
The Keyboard Scanner utility 
includes an alternative keyboard 


When not volunteering at The 
National Museum of Computing 
or running the Milton Keynes 
Raspberry Jam, PJ can be found 
installing Raspberry Pi devices 
where no-one asked them to be. 
mrpjevans.com 
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mapping mode. When it detects 
a press of our switch, it toggles 
between ‘normal’ mode anda 
second mode that converts the 
number keys into their function 
key equivalent. 


TIME SCANNERS 

To get your Raspberry Pi working 
with the membrane keyboard 
input, we use a Python script to 
scan the keyboard for presses and 
inject them into the kernel. The 
script outputs a current through 
all address lines (KB2) and drops 
the current to each one in turn 
about 60 times a second. 

If a key is pressed, we can detect 
which data line it’s on, and we 
know which address line was being 
checked, so we know which key 
was pressed. The result is passed 
to a piece of software called uinput, 
which turns it into a key press. 

The ZX Raspberry Keyboard 
Scanner script is designed to work 
with RetroPie (see page 18) and 
the FUSE Spectrum emulator, but 
you’ll find instructions for other 
distros on its home page. 


We can use Git to pull down 
the script and its dependencies. 
First, let’s make sure we have the 
essentials to install everything: 


sudo apt install get 
libudev-dev python-dev 
python-pip 

sudo pip install wiringpi 


Now install Libsuinput: 


cd 

git clone github.com/ 
tuomasjjrasanen/libsuinput 
cd libsuinput 

./autogen 

./configure 

make 

sudo make install 


Make sure uinput is loaded 


every time the Raspberry Pi boots. 


Add the following line to /etc/ 
modules-load.d/modules.conf: 


uinput 


You can load it right away 
without rebooting by typing: 


sudo modprobe uinput 
And install Python-uinput: 


cd 

git clone github.com/ 
tuomasjjrasanen/python- 
uinput 

cd python-uinput 

sudo python setup.py build 
sudo python setup.py install 


Download the scanner script: 


cd 
git clone github.com/ 
mrpjevans/zxscanner 


And test it. Carefully connect 
your ZX Spectrum membrane to 
the Molex connectors and run 
the following from the project 
directory (ideally from an SSH 
session on another computer): 


cd ~/zxscanner 
sudo python zxscanner.py 


Now try the keyboard. Each 
key press should produce a letter 


Looking quite bare 
compared to the 
original, but with 
buckets more 
power and storage 
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on screen. The SSH session will 
show debug output. Check the 
switch too. 

The script needs to run at 
boot. Start by making the 
file executable: 


sudo chmod +x ~/zxscanner/ 
zxscanner.py 


Then create a service file and 
enter code from startzxscanner. 
service. Our zxscanner.service 
file needs to contain the following 
so the OS knows how to start 
the scanner: 


sudo nano /usr/lib/systemd/ 
zxscanner.service 


Finally, we enable the service so 
the scanner is always running: 
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sudo systemctl enable 
/usr/lib/systemd/zxscanner. 
service 

sudo systemctl start 
zxscanner.service 

sudo systemctl daemon-reload 


When used with RetroPie and 
FUSE, a tap on the button will 
cleanly close FUSE, although you’ ll 
have to configure the emulator 
not to prompt for confirmation. 
A 3-second press will switch the 
keyboard so keys 1-4 become F 
keys (so you can get to FUSE’s 
menu) and 5-8 act as cursor keys. 

A world of ZX Spectrum 
gaming and programming now 
awaits you. You can, of course, 
use your new ZX Raspberry to 
emulate other computers... 
even a Commodore 64. 


Left The Speccy's 
keyboard matrix 
allows you to 
detect inputs for 


40 keys using just . 
13 lines. Perfect for 
the GPIO a 


RIBBON SOLDER GUIDE 
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CLASSIC 
COMMUNITY 
BUILDS 


THE GREATEST RETRO COMPUTER PROJECTS 
BUILT USING RASPBERRY PI 


Dom Cresswell of Facebook’s 
RetroPie Makers has built a 
Raspberry Pi-based Amiga 
emulator build running the 
Amiberry emulator inside a new 
A1200 reproduction case. 

“The Raspberry Pi really inspired 
me, and since I had already ordered 
two new A1200 cases from the 
A1200.net Kickstarter campaign, 
the blue one seemed perfect for 
a Raspberry Pi 3, and the colour 
matches our living room, so when 
my wife said she was happy to 
let me start using it as our media 
centre, I really wanted it to be the 
best it could be. 

“T am still waiting for a set of 
black keys to be produced, but 
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I’m very happy with the rest. The 
keyboard works, and is controlled 
by the excellent KeyRah v2 USB 
device and the lights are Conny 
Larson’s Bifrost replacement 
A1200 LEDs, although I had to do 
a bit of work getting them to work 
from the GPIO control voltage. 
“Probably the part Iam 
proudest of, though, is the back 
panel - all done without any 
changes to the original case; I 
bought some blue sheet plastic 
and did a lot of careful Dremel 
cutting to make some panels 
which could just be hot-glued in 
place, complete with the ports... 
the finish looks really great and 
much tidier than I had expected!” 


When both his beloved 
Commodore Plus4 computers 
stopped work, Ian Hill turned to 
his Raspberry Pi to bring them 
back to life. 

“The Plus4 was my first real 
computer, but they tend to 
overheat and burn out some of 
the chips inside, which are not 
available any more, meaning once 
they’re dead, they stay dead. 

“T have two dead Plus4s, so I 
replaced the internals of one of 
them with a Pi Zero, Keyrah V2, 
and Combian64 software. The 
result is a Commodore Plus, that 
very closely resembles the original, 
and can switch between Plus4, 
C64, and VIC-20 modes, with all 
the available software for all three 
machines built in.” 
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THE CASE MAKER 


While some Raspberry Pi fans have 
converted favourite computer 
chassis into cases and keyboards, 
Stephen Eddy of RetroPiCases.com 
started remaking his favourites 
7 /using a 3D printer and turned 
his passion into a vibrant 
small business. 

“Each case model takes me 
around a month to design and 
produce. Initially I look at the 
source computer models, then 
look for design cues that I can 
incorporate into my own models. 
Because the Raspberry Pi is 
completely different dimensions 
to the original computers and the 
position of the ports are fixed, I use 
the design cues to make the model 
recognisable as a computer from 
the original family.” 


THE THROWBACK: FUZE 


built-in Raspberry Pi 3 and a heap 
For those who want aretro-styled of electronics project accessories 


keyboard and chassis, but aren’t for £169.99 or as a stand-alone 

up for the soldering involved, the case for £90. 

FUZE (not to be confused with The FUZE BASIC programming 

the FUSE Spectrum emulator) is a language, an updated version of 
Perfect, coe Penns nee Pac can | ube downloaded 


USE YOUR ORIGINAL 
CONTROLLERS 


This is actually the reborn 
Competition PRO Retro made 

by Individual Components 
(icomp.de), but you can do the 
same project with any old joystick 
or game controller. It seems 


Of 2N RETROPIE MAKERS 
like sacrilege to cut the end offa ai % | ; 

i . nal > magpi.cc/2EqwwaE 
functional controller, so your best Sn lll . 


bet is to order some connector KEYRAH USB KEYBOARD DEVICE 
ports (or pull some out of a dead > magpi.ce/2ErTz50 


COMMUNITY 
RESOURCES 


acl 
~~ 
A, 
_ 
th 


VE yyeyyy 


computer or console). 

There are some great dedicated BIFROST LEDS 
connector boards to hook your > magpi.cc/2EnXXCa 
controller into the Raspberry Pi’s ——— IAN HILL’S COMMODORE 
GPIO. An alternative is to use = = PLUS 4 BUILD 
serial cable and some breadboard — 2 > magples7sEpasey| 
to connect it and feed into a ; . 7 
driver module created by the <p ~ =— RETROPIE CASES 
RetroPie team. = a ne > retropicases.com 


Rolling Subscription 
£4amonth 


NO OBLIGATION! 
LEAVE ANY TIME’ 


Quick and easy to set up 


No long-term commitment 


am Subscribe for a year: 
£55 
£80 
Free delivery to your door 
£90 
Exclusive Raspberry Pi offers and discounts 


Get every issue first (even before stores) £95 
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FREE 


SUBSCRIBE ON 


GET ITON 


> Google Play 


4 Available on the 
@ AppStore 


raspberrypiorg/magpi 


PI ZERO W fie 
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ehaaa 
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Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 


Camera Module 
connector 


March 2018 


» Josh wanted 
the robot to 
cost under 
$1000 


> It's IR sensitive 
to record in 
the dark 


» Four Raspberry 
Pi 3s are used 


» Itincludes an 
anti-theft GPS 
303D tracker 


» Josh made 
extensive use 
of EZ-Robot's 
EZ-Builder v4 


SECURITY ROBOT 


Big Brother on wheels or the potential future of law enforcement? 
Josh Starnes’s robot security guard is an arresting sight, 
as David Crookes discovers 


Ithough our city streets are 

packed with CCTV cameras, 

past reports have suggested 
that many are either in the wrong 
place or simply don’t work. 

“Someone can throw their hoodie 

on and hide from a high-mounted 
camera,” argues Josh Starnes. 
“People are less likely to misbehave 
when someone is physically there 
to witness it.” 


The bucket top has been 
waterproofed to protect the 
electronics - four Raspberry Pi 3s 
record video and upload it to a PC 


‘i 


W/, 


So what is the answer? A lack 
of resources means flooding the 
streets with police isn’t always 
economically viable. “But would 
you be surprised if a robot rolled 
up, recording or talking to you 
while you are up to no good” asks 
Josh. “I would.” Which is why he 
has created a security robot to do 
exactly that, called Watchdog. 


Inspired by sci-fi movies such as 
Short Circuit, Evolver, and Star Wars, 
Josh got to work on an affordable 
DIY robot that can trundle around 
the streets, operate in cold and wet 
weather, work well in low light, 
and communicate. He wanted it to 
record HD video locally and stream 
via WiFi to a secondary source for 
online viewing. “I decided to use 
a Raspberry Pi. It has an excellent 


The 130-degree camera lenses 
have an easy adjustment to get 
a clear shot at 10 to 15 feet 


The Jazzy Select chassis was fitted 
with more aggressive Carlisle 
Knobby tyres and a 10-inch inner 
tube for improved turning grip 


WATCHDOG SECURITY ROBOT 


Projects 


>STEP-01 


community and it’s moved past 
being a new gadget to a useful tool.” 


Pi spy 

At first, Josh spent time getting 
the chassis right, using the base 

of a Jazzy Select power chair. He 
stripped away unwanted parts 
such as the chair, footrest, original 
Jazzy electronics, and the front 


The Raspberry Pi meant | 
could pick the camera module 


I needed 


anti-tip wheels. He also bought 
a Sabertooth dual 12 A motor 
driver which is optimised for use 
in medium-powered robots and 
radio-controlled vehicles. 
Struggling to find an off-the- 
shelf camera that met all his needs 
he turned to the Pi 3: “It meant 
I could pick the camera module I 
needed, record to a hard drive, and 
have remote access.” Josh used 
four Pi 3 boards, each connected to 
acamera. “In the event one fails, 
all the others are independent and 
would continue recording.” 
The project uses the Pi NoIR 
Camera Module, which has a 


) 
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>STEP-02 


5MP sensor, night vision, anda 
130° adjustable-focus lens. Four 

of these are mounted inside the 
robot’s head — the upper half of a 
five-gallon bucket with a screw-on 
lid and a treated plywood bottom. 
Motion and ultrasonic sensors are 
also mounted within the head. 
These enable the robot to detect 
obstacles and movement. 


Easy does it 

With the Raspberry Pi handling 
the video recording and managing 
the broadcast, Josh was able 

to produce a robot that could 
scan its environment, roll up to 
wrongdoers, and record. “I used 
EZ-Robot’s EZ-Builder software. 
They have some wonderful tools 
that allow use of radar-style 
ultrasonic navigation, machine 
vision, and movement controls.” 
He found creating a movement 
routine to be straightforward: 
“EZ-Builder has modules you 
can insert that write complicated 
scripts for you.” 


Above top Josh 
cut off the upper 
five inches ofa 
five-gallon bucket, 
using a stepper 
bit to get the 
right-sized holes 
for the cameras 
and sensors 


This gave Josh more time to get 
the Raspberry Pi to record while 
broadcasting. After trying the 
motionEyeOS system but only 
achieving 10 frames per second, 
he turned to Python and wrote 
something himself. Meanwhile, 
he continued to work on the look 
of Watchdog, painting the robot a 
cool gunmetal grey. Today, while 
it’s still a work in progress, it’s 
almost ready for action. 


Above Josh 

picked up this 
Jazzy Select on 
Craigslist and used 
parts from other 
Jazzys to made the 
perfect chassis 
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>» openMHA 
can process 
audio signals 
in real-time 


» Itcan be 
adapted to an 
individual's 
hearing loss 


» Delays 
between input 
and output 
audio is 

below 10ms 


> There's no GUI 
- except for 
fitting the 
amp parts 


» Funding came 
from the 
US National 
Institutes 
of Health 


may ys . 
. wy ' 
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RING AID 


When looking for a way of testing hearing aid algorithms outside 
of the lab, a team of researchers realised a Raspberry Pi could be 
a sound investment. David Crookes listens to their idea 


or millions of people 

around the world, hearing 

aids are hugely beneficial. 
Not only do they allow people to 
hear better, they have been shown 
to lower the risk of dementia, the 
potential for loneliness, and the 
likelihood of people withdrawing 
from social situations. 

But while a lot of research has 
gone into developing hearing aids 
over the years, Tobias Herzke, 

a signal processing engineer at 
HorTech in Oldenburg, Germany, 
says: “There is still a lot of potential 
for improvement, especially in 
acoustically difficult situations.” 

For that reason, the company 
— a spin-off of the University 
of Oldenburg — developed 
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openMHA, which was designed to 
be acommon, portable software 
platform for hearing aid research 
and teaching. “The openMHA 
platform allows for real-time 
audio signal processing with 

low delay,” explains Hendrik 
Kayser, who develops signal- 
processing algorithms for digital 
hearing devices. 

By providing a set of standard 
algorithms to form a complete 
hearing aid, openMHA can process 
the signal from a live microphone 
and perform different tasks such 
as amplification, directional 
filtering, noise reduction, and 
feedback suppression. Testing 
new algorithms is not always 
straightforward, however, which 


Hendrik Kayser (left) and Tobias 
Herzke (right) 


is where the Raspberry Pi can come 
into its own. 


Testing times 

“The openMHA software can 
execute on Linux computers in 

a laboratory environment, but 
the sound environment ina lab 
will always differ from real sound 
environments encountered by 
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HEARING AID RESEARCH ‘Projects 


hearing aid users in real life,” Tobias Pi provide decent computing HE AR TH AT NOLEINID) 


tells us. In the past, this has often capabilities at lower power 
led to skewed results that do not consumption and small size,” adds 
offer a true reflection of how hearing Hendrik, who says the Raspberry Pi 
aids are used. Yet using ARM-based _has the best price-to-performance 
devices such as the Raspberry Pi ratio and loves the bonus of on- 
offers a wonderful solution. board wireless. “They have allowed 
By running openMHA ona us to offer a complete, working 5 
Raspberry Piand taking advantage _ hearing aid signal-processing chain 
of its portable nature, the and keep the cost below $300.” 3 ; 
researchers can evaluate new The knock-on effect of this 
algorithms in real-time and in has been significant. “By using 
realistic outdoor conditions. “It the Pi, we have lowered the entry = 
has allowed us toimplement anew __ barrier for hearing aid algorithm =k “Ul 
algorithm on a mobile device in development and evaluation, for Grab a Raspberry Pi 
order to find out how it sounds in students at university and amateur Originally, portable testing of the openMHA software 
real-time when running around hearing enthusiasts who lack platform was carried on on a Linux laptop. Marc 


René Schadler, leading a hearing research group at 
University of Oldenburg, felt a Raspberry Pi would 
work better. 


We have lowered the entry 
barrier for hearing aid 
algorithm development 


with a hearing aid,” says Tobias. As __ the resources to invest in large- oe 
such, it gives research in this field scale setups,” says Marc, who is . rN 


> 


; a 

a real boost by providing better leading a hearing search group at 

quality and more relevant data to the university. What’s more, by : : 

work with. using openMHA for the software, - — 
Raspberry Pis, and commercially | 

Loud and clear available headsets and sound — 


It certainly beats lugging a Linux cards, the team is able to ensure oe 

laptop around and it has also the system is stable and flexible. SIEP-UZ 

enabled the researchers to cut “Low cost, high availability Add a sound card 

costs. “Small systems like the through off-the-shelf components, Marc took a Raspberry Pi 3, loaded the Raspbian 
mobility, no proprietary solutions, Stretch OS on to a 32GB microSD card, snapped up 

Bciee Seis eel We community support, and easy an Audio Injector Stereo sound card, and cloned the 

‘hearing aid’ to the individual's hearing access to hearing aid software were openMHA source code. 


loss. This is done by plugging a monitor : ae « 
into the Raspberry Pi and firing up the the most important driving points 


Fitting GUI here,” concludes Marc. 


es ....- - 
| camfit_cicand_right 
camnt_compr 
camht linear 


lveerso 


Prenres 


FirstFit (LR) JOLOKOS2 CR * 


Calibrate and set up 

According to Marc, calibrating the setup before using 
it is vital. “Hearing aid algorithms need to know the 
absolute physical sound of the input,” he says. This 
has been worked into the project. 
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The Touch Board and 
the Raspberry Pi are 
mounted behind the 
canvas, inside the frame 


» The title 
comes froma 
Philip Larkin 
poem 


» The recurring 
bird in the 
canvas 
symbolises 
spirit 


» The original 
drawing was 
a3metre 
panorama 


» The Touch 
Board costs 
£60 ($85) 
from Bare 
Conductive 


» Bare 
Conductive 
also makes 
conductive 
paint 


The work can be mains- 
powered or use a LiPo 
battery, depending on 
where it is displayed 


pt cel eo 


A rare fusion of handicraft and the 
Raspberry Pi has been displayed in the 
world-famous V&A Museum, alongside 
works by Raphael. Sean McManus reports 


To experience the artwork, 
viewers put on the 
headphones to hear the 
accompanying soundtrack 
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andering through London’s 

V&A Museum in December, 

you had a chance to see 
works from two major cultural 
movements: the Renaissance, and 
the maker movement. On the wall 
were paintings from 1515, designs 
by Raphael for his celebrated 
tapestries. On an easel was a modern 
work by Stewart Francis Easton that 
combines embroidery, music, and 
the Raspberry Pi 2. “I shared a room 
with Raphael. Just me and Raphael. 
That’s the dream,” Stewart says. 

His work is called The Next Verse, 
and was part of a digital event at 
the gallery. It depicts the cycle of 
life, using scenes of a family along 
a snaking path through the canvas. 
“From childhood to death and round 
again,” explains Stewart. “You begin 
with a father and child and end with 
that child’s son releasing the spirit 
of his father to enable the cycle to 
begin once again.” 

The work is completed by a 
soundtrack. There is a 23-minute 
composition by Michael Tanner, 
performed on a psaltery, a 
stringed instrument often seen in 
medieval paintings. Additionally, 
viewers can trigger sounds. “Each 
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Above Viewers touch the conductive 
thread of the triangles in the canvas to 
trigger sounds relevant to each scene 


illustrated event has a small 
triangle stitched next to it,” 
reveals Stewart. “The viewer is 
required to touch these triangles 
(one at a time) to trigger the sound 
that corresponds to the storyline.” 


Ambient sounds 
Gawain Hewitt created eight 
sounds for these points in the 
journey. “One of the sounds has 
a bellows playing — almost like 
a broken accordion with static 
sounds and whistling,” says 
Stewart. Another has a recording 
of sounds made at his daughter’s 
school playground. These sounds 
were all required to be able to be 
played along with the original 
soundtrack which plays on a loop. 
Gawain also carried out the 
technical implementation, which 
is based on the Touch Board, made 
by Bare Conductive. Although the 


>STEP-01 
Adding the thread 


Stewart stitched triangles alongside 


scenes in the canvas, using conductive 
thread. The triangles are connected on 
the back of the canvas with a wire loop 


>STEP-02 


Connecting the Touch Board 
The wires from the canvas are soldered 
to the electrodes along the edge of 
the Touch Board. The Touch Board can 
then be connected over USB to the 


that goes to the Touch Board. 


for me is the ability to code in an 
exploratory way,” he says, “so 
that the act of coding software is 
a creative act. I have a background 
in audio engineering, so I find the 


I shared a room with Raphael. 
Just me and Raphael. 
That's the dream 


Touch Board can be used to trigger 
MP3s or play MIDI sounds itself, 

it can only play one audio file at 

a time. Using the Raspberry Pi 
enabled Gawain to code polyphonic 
software, and use high-quality 
uncompressed audio files. 

Gawain wrote the software using 
Pure Data (Pd), an open-source 
visual programming language 
for multimedia. “One of the 
really beautiful things about Pd 
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interface and ‘metaphor’ used very 
empowering and intuitive.” 


Conductive thread 

The triangles on the canvas use 
conductive thread to detect touch. 
So, what limitations does it present 
as a material? “From a purely 
aesthetic viewpoint it’s the colour 
of the conductive thread,” says 
Stewart. “I think you can only get 
either grey/silver or gold.” 


Raspberry Pi. 


>STEP-03 

Using the Raspberry Pi 
The Raspberry Pi uses 
software written using Pure 
Data to trigger the spot 
effects and loop the music. 
A Terratec USB sound 

card feeds audio into a 
headphone amplifier. 


Gawain adds: “You do need to \bove Because 
; er a viewers use 
consider its inherent fragility, headphones, 


interacting with 
the artworkisa 
highly personal 
experience 


and try to avoid crossed lines in 
the wiring for better capacitive 
touch. Also, it can get dirty 
when touched!” 

For the next verse of their 
creative collaboration, Stewart 
and Gawain have several works 
in progress, including some that 
might use lights triggered by sound 
running through a Raspberry Pi. 
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» The Lunchbox 
measures 17 
12 x 6.3cm 


>» A5200mAh 
power bank 
supplies the 
juice 


» It'llrun for 
about an hour 
per charge 


» Build details 
can be found at 
magpi.cc/ 
2nw@tlE 


» Danielis 
working on 
four new Pi 
projects 


MINI 


ARCADE 


Never mind a packed lunch, have a Pac-Man lunch 
with this mini retro arcade in a box. By Phil King 


aving already built a full- 

size tabletop-style arcade 

cabinet powered by a 
Raspberry Pi, Daniel Davis wanted 
to make something a little more 
portable to feed his passion for retro 
gaming. So when he acquired an 
old metal lunchbox, the last thing 
on his mind was using it to store 
sandwiches. Instead, he opted to 
pack it with a retro arcade system 
built using a Raspberry Pi 3, Adafruit 
Backpack 5-inch HDMI touchscreen, 
Adafruit Arcade Bonnet, speaker, 
plus an analogue joystick and mini 
arcade buttons. 


“The challenge was sourcing 
arcade buttons and components 
that would fit,” says Daniel. “For 
instance, standard-sized arcade 
buttons were too large to fit inside. 
Talso had to take into consideration 
the depth of the screen so that when 
the lid closed, it didn’t smash into 
any of the other components.” 


Neat and tidy 

Rather than simply cramming 
components into the box, Daniel 
wanted to make the system 
organised and easy to use, “so 
that anyone could open it up and 


be familiar with the control layout 
(which mimics that of an NES 
controller or Game Boy).” 

To keep everything looking 
secure, and hide the wiring, Daniel 
3D-printed a screen holder and 
controller board that he’d designed 
inaCAD program. “Once I had all 
the components laid out, I dida 
couple of test prints to make sure 
everything fit, but then I realised 
that I hadn’t designed anywhere 
for the wires to go (especially for 
the screen). So I had to go back and 
redesign the casing to allow room 
for the various wiring.” 


Games are run in 
RetroPie and displayed 
ona5-inch touchscreen 


The arcade controls and 
speaker are fitted into a 
3D-printed board fora 
neat finish 
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Since the metal box is 
conductive, it had to be 
lined with insulating tape 
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The system runs 
the RetroPie retro 


gaming OS ona 
Raspberry Pi 3. 

A software fix was 
required to ensure 
the interface filled 
the screen 


Daniel recalls that a lot of time Raspberry Pi HATs and bonnets 
was spent measuring, testing, which “made everything a breeze 
and measuring again. “I went to connect. Aside from that, the 
through several different types of available software for the Pi to make 
arcade buttons before I found ones arcade emulation possible is also 
that did the job and fit in sucha something that has become a lot 
small space.” better over the years.” 
Ensuring that the control panel Daniel spent about 20 hours, 
was low enough to allow enough spread over several weeks, to 
room for the screen when the box complete the build. The end result 


I went through several different 
types of arcade buttons before 
I found ones that did the job 


was closed was another crucial is acute and compact arcade system 
factor: “If the lunchbox couldn’t that’s simple to pick up and play 
close properly, it defeated the whole (youtu.be/h8nhqowESKg). 
purpose of the project.” Upon being shown the Mini 
Lunchbox Arcade, Daniel’s nephew 
Arcade experience was “really shocked to see what was 
Daniel tells us that his previous inside. He was able to immediately 
experience of building an arcade figure out how to turn it on and start 
cabinet in 2013 helped when playing a game. He did say that if 1 
approaching this much smaller could find a way to sell them, all of 
project. Since then, the build his friends would buy one and I'd 
process has become a lot easier, make a million dollars. That’s quite 


thanks to the availability of various the endorsement!” 


The joystick, arcade buttons, and 
mini speaker were hot-glued to 
Daniel's 3D-printed controller board 
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RASPBERRY PI! 101: BEGINNER'S GUIDE TO WOLFRAM MATHEMATICA 


Perform advanced mathematics using the powerful program installed with Raspbian 


Raspberry Pi 


> Raspbian 
desktop 


The ‘Show/Hide all results’ button displays extended 
i = information including plots and expansions x =o 
Free-form input enables : “ cn Oe 
you to enter mathematical 


equations in linguistic form Step-by-step solutions explain 


how to solve maths problems 


[Edit Insert Fogmat Cell Ezatuation Bvlettes window Help 


5 limit of sin x as x approaches pu2 © 
Limit (Sint) eid Pis2) 


tom 


| — 7 — 
OP sete stint), x -> PH 2) 


| ai 


| Pox 


Plot iStalx), (xy -5.02655, 6.26814)) | 


| Sores expenses a xe rs 2: 


Sarton [Sintxyy (xy PH/2, 89) 


t= Ble= SP zelen$) sled ele“) 
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WOLFRAM MATHEMATICA | Tutorial 
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The WolframlAlpha Knowledge Base offers a wealth of global data 


(default ) 
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ace | 
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i 
Mathematica makes it easy to view graphs of equations : ; 


Tutorial 


Use two Wii Nunchuks to play this unique fast-paced game 


e love mazes here at the Bakery, but steering Wii Nunchuk. But the twist is that you can’t see the 


through one on a computer has its problems. walls in the maze: if you walk into a wall then you are 
Sali Basically they are either too easy or too instantly whisked back to your starting point. There 
F cones difficult. The Secret Labyrinth is hard but intriguing. are no player turns — just move as quickly as you can — 
nehanle It can be played as either a two-player or single- and the maze is constructed so that the path from the 
> 2» Nuncnuc é A : . . 
adapters . player game. The players begin at opposite corners of bottom to the centre is the mirror image of the path 
magpi.cc/ a maze and have to find the centre by using a series from the top to the centre, so both players face an 
2rzendj of horizontal and vertical moves controlled by a identical task. 
> Stripboard: 24 = _ 
strips of 13 holes a 


> Z4HTC4052 
analogue 
multiplexer 
magpi.cc/ 
2rArKCy 


The Labyrinth with 
the walls temporally 
revealed 


> 16-pin IC socket 


> Bottom-entry 


twin-row header 
sockets 


> 4 68kQ 
resistors 


> 0.1pF ceramic 
capacitor 


These are the 
Wii Nunchuks, 
the secondary 
part of the Wii 
Remote controller 


The Nunchucky adapter 
allows you to connect the 
Wii Nunchuks to the Pi 


Tutorial 


Nunchuks labyrinth.py 


The Wii Nunchuk is a cheap and remarkable interface. 


While in this project we will just be using the X-Y @@1. import sys, random 
joystick, the Nunchuk also contains two push-buttons 802. from smbus import SMBus DOWNLOAD: 
and a 10-bit three-axis accelerometer. They are 603. import RPi.GPIO as io magplee/aNeliov 
interfaced through the [°C bus to the Raspberry Pi, but 004. import pygame, os, time 
there is a small problem: each device on an I?C bus 05. 
needs to have a unique address and all Nunchuks have 006. pygame. () # initialise graphics 
the same address, fixed in the hardware, that can’t be interface Check out Mike's 
changed. So to get round this problem we have to split 007. pygame.mixer.quit() Bakery videos at 
F : F ee8. .mixer. (frequency=22050 magpi.cc/aNqJnTz 
the bus by steering the PC signal lines to one Nunchuk Dye ame SMX Ie 
or the other by using an analogue multiplexer chip. size=-16, channels=2, buffer=512) 
@@9. os.environ['SDL_VIDEO_WINDOW_POS'] = ‘center’ 
Q10. pygame.display. ("Secret Labyrinth") 
@11. pygame.event. (None) 
Q12. pygame.event. (Lpygame . KEYDOWN, pygame.QUIT]) 
@13. 
014. gSpace = 70 # size of square 
@15. gSide = 9 # number of squares per side 
916. nSquares = gSide*gSide 
@17. screenSize = gSpace * gSide 
@18. screen = pygame.display. ([screenSize+2,screenSi 
ze+2],0,32) 
@19. random. () 3 centre = (nSquares-1) // 2 


028. refresh True ; joyLast = [-1,-1,-1,-1] 
@21. playPos = [0,0,0,0] # current and start position 
@22. maskFrom = [8,2,1,4] 


>STEP-O1 @23. dirInc = [-1,1,-gSide,gSide] # direction movement 

Preparing the board 024. wallcolour = (0,255,255) # for revealed labyrinth 
025. 

Take a piece of stripboard 24 strips wide by 13 holes @26. main(): 

high, and break the tracks shown by the dark areas @27. global refresh, done 

with a scalpel or spot face cutter. The dotted lines e28. done = 

show the positions of the IC socket and the four @29. 6) 

bottom-entry sockets. The board will hang over the 030. () # load in sound and graphics 

side of the Pi, not over the printed circuit board. @31. () # create maze 


3V3 
O.1UF 
GND Vss 
Vee 
Inhibit 6 
SCK 
GPIO3 13 
2c 
GPIO2 SuA 3 
GPIO4 Control A 
Control B 
GPIO17 


>STEP-02 
Underside of the board 


The board will be plugged into 
the Raspberry Pi’s GPIO header. 
Only six connections are needed 
electrically, but we have used a 
second four-section of socket 
for mechanical balance. The two 
four-length sections of socket are 
for the Nunchuk adapters to plug 
into. Solder these sockets up 
before commencing 

the wiring. 


4052 


16 


SCKO 
SCK1 
SCK2 
SCK3 


SDAO 
SDA1 
SDA2 
SDA3 


Nunchuk 0 


3V3 
SDA 
SCK 


GND 


Nunchuk 1 


BYTE 
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Figure 2 Registers returned by the Nunchuk 


The multiplexer needs to be analogue because signals 
can go from the Raspberry Pi to the Nunchuk, or from 
the Nunchuk back into the Raspberry Pi. However, all 
we need to do is to set the multiplexer’s select pins 
and talk to the Nunchuk normally, and the selected 
Nunchuk replies. 

The schematic for this board is shown in Figure 1 
and full construction is shown in the step-by-step 
section. The Nunchuk itself when read, sends back a 
block of six bytes; each byte holds different data and 
a map of this data is shown in Figure 2. Note how the 
least significant two bits of the accelerator readings 
are in the last byte. This allows a simple access to an 
8-bit reading as often the last two bits are noise. The 
two push-buttons are in this last byte as well. 


The maze 

The game is set ina 9x9 grid with players starting at 
the upper and lower corners. Due to the symmetry 

of the maze, it is in fact a 9x5 grid that contains the 
maze, but there is no restriction on a player going into 
the other half. Each square has four possible exits and 
these are marked as either blocked or clear in the list 
that holds the definition of the maze. So by checking 
the exit side of a square you want to move from, this 
will either allow free passage or send the player back 
to the start square. The maze is generated by starting 
at the centre and then moving in a random direction 
until a corner is reached. That corner becomes the 
start position for the player. On each random move, 
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while 1: 
while not(done): 
checkForEvent() 
if refresh : 
drawScreen(False) 
refresh = False 
time.sleep(3.5) # see the walls 
mazeGen() 
done = False 


change to True to hide view 


def drawScreen(laby): 
rSize = gSpace 
pygame.draw.rect (screen, (0,0,08),(@,0,screenSize, 
screenSize) ,@) 
#draw Tiles 
for s in range(@,nSquares): 
xp = findX(s) 
yp = findY(s) 
screen.blit(tiles[tilePlan[s]],(xp,yp)) 
#draw grid 
if not(laby) : 
for y in range(@,gSide+1): 
pygame. draw. line(screen, (255, 255,0), (gSpace*y,@), 
(gSpace*y, screenSize+2) , 2) 
for x in range(@,gSide+1): 
pygame. draw. line(screen, (255, 255,0),(@,gSpace*x), 
(screenSize+2,gSpace*x), 2) 


#draw players & prize 

xp = findX(centre) 

yp = findY(centre) 
screen.blit(prize, (xp,yp)) 
xp = findX(playPos[@]) 

yp = findY(playPos[@]) 
screen.blit(tux1, (xp, yp) ) 
xp = findX(playPos[1]) 

yp = findY(playPos[1]) 
screen.blit(tux2, (xp,yp) ) 


# draw labyrinth 
if laby : 
for s in range (@,nSquares): 
xp = findX(s) 
yp = findY(s) 
for side in range(@,4): 
if not(maze[s] & 1) : 
pygame. draw. line(screen,wallcolour, (xp, yp), 
(xp+rSize, yp), 2) 
if not(maze[s] & 2) : 
pygame.draw. line(screen,wallColour, 
(xptrSize, ypt+rSize) , (xptrSize, yp), 2) 
if not(maze[s] & 4) : 
pygame.draw. line(screen,wallColour, 
(xptrSize, yptrSize) , (xp, yp+rSize) , 2) 
if not(maze[s] & 8) : 
pygame.draw. line(screen,wallColour, (xp,yp), 
(xp, yp+rSize) , 2) 
pygame.display.update() 


March 2018 MagPi 


Tutorial Wane: 


>STEP-03 
Wiring up 


>STEP-04 
Wiring up 


the side o 


between t 


f the square just gone through is marked 


as clear and the side of the destination square is also 
marked as clear. This allows two-way movement 


hese two squares during the playing 


phase. The sides are marked as clear by setting the 
appropriate bit in the maze list element for that 


square. This is summarised in Figure 3 (overleaf). 
The side of each square is labelled clockwise 
> from the top with the letters A to D. So if the 
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maze-generating program moves from the current 
square through side D, then bit 3 of the maze 
variable is set and the square it moves to (the one 
immediately to the left) has bit 1 for side B also set. 
This then becomes the current square and another 
random movement is made. There are constraints 
to stop the random movements occurring off 

the edge of the playing board, so that the whole 
board is ringed by blocked moves; this simplifies 
the playing logic. When any side of a square is 
cleared, the mirror image of that square and side 
are also cleared. 


The resources 

Each square of the board has a tile background chosen 
at random from a number of tiling strategies. Here 
we have implemented random tiles, diagonal rows of 
the same tile, displaced repeating, and all the same 
tile. Note how diagonal rows are simply displaced 
repeating with the displacement equal to one. We 
found that the tiling scheme as well as adding variety 
to the game also affected the way you play. We chose 
to use two versions of Tux, the Linux penguin, as the 
playing pieces. All tiles and playing pieces should be 
scaled to 72x72 pixels. We again raided the Scratch 
media files to get the sounds for when a player crosses 
a blocked boundary and is sent back to the start. 

A screen dump of a game in progress is shown in 
Figure 4 (overleaf). 


The software 
The software for the project, labyrinth.py, uses our 
favourite Pygame frame work. It uses the smbus 
extension to handle the [°C interface — make sure it 
is enabled in the Interfaces tab of the Raspberry Pi 
Configuration tool. The main function is quite simple 
and consists of an infinite loop repeatedly playing 
different games. The inner while loop just plays 
one game by checking for an event or move and, if 
necessary, redrawing the screen. At the end of the 
game, the maze’s hidden walls are revealed for a few 
seconds before generating a new maze and starting 
the play again. The drawscreen function takes ina 
Boolean value that determines whether the real walls 
are to be shown or if every square seems to have a 
wall. For very small people, you might want to play 
the game with the walls shown — simply change False 
to True in the drawscreen function call to do this. 
The mazeGen function is perhaps the most complex 
in this code. It starts off by selecting a tile strategy at 
random and generating a tilePlan list which stores 
the tile number associated with each square. In the 
same loop, the old maze is erased. Then the centre 
square is set so that it has no barriers around it and 
the random walk clearing the walls is begun from 
the centre until either top corner is visited. That 
completes the maze and ensures at least one path 
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findX(square): 
return (square % gSide)*gSpace 


findY(square): 
return (square//gSide) *gSpace 


initI0(): 
global bus 
io.setmode(io.BCM) 
io.setwarnings(False) 
select = [4,17] 
io.setup(select,io.OUT) 
io.output(select,@) # select nunchuck @ 
print("Initialise I2C") 
if io.RPI_REVISION == 1: 
i2c_bus = @ 
else : 
i2c_bus = 1 
bus = SMBus(i2c_bus) 
for nun in range(@,2): 
bus.write byte data(@x52,0x4@, xe) 
io.output(4,1) # select nunchuck 1 
time.sleep(@.01) 


init(): 

global bus,sounds, maze, tuxl, tux2, prize, tiles, tilePlan 
global finish, resetPlayer 

tuxl = pygame.image.load("images/Tux1.png").convert_alpha() 
tux2 = pygame.image.load("images/Tux2.png").convert_alpha() 
prize = pygame.image.load("images/present.png").convert_ 
ha() 

tiles = [pygame.image.load("images/Tile"+str(t)+".png"). 


convert_alpha() 


def 


for t in range(@,15)] 
finish = pygame.mixer.Sound("sounds/finish.wav") 
resetPlayer = [pygame.mixer.Sound("sounds/Pop.wav"), 
pygame.mixer.Sound("sounds/Rattle.wav")] 

maze = [] 
tilePlan = [] 
for sr in range(@,nSquares): 

maze.append(@) # create maze array 

tilePlan.append(@) # pattern of tiles 


readNck(nunNum): 


# the I2C drivers or something throws up an occasional error - 
this is the sticking plaster 


io.output(4,nunNum) # select the right nunchuck 
time.sleep(@.004) 
tireye 

bus. .write_byte(@x52,0) 
except: 

print("bus restart") 

time.sleep(@.1) 

initI0o() 

bus.write_byte(@x52,0) 
time.sleep(@.002) #delay for Nunchuck to respond 
nck = [((bus.read_byte(@x52) * @x17) +0x17) for i in 


range(@,6) ] 


return nCk 
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D To square 


Sides of a playing square 
and its attributes 


through it has been generated. We have a version of 
the program in our GitHub repository that uses only 
keyboard keys to move. Finally, the G key will give a 
glimpse of the walls for a second or two — only to be 
used if you are really stuck. 


Taking it further 

You could add a timer and keep a high score of the 
speed of arun. Or you could change the game into 

a turn-based affair. As the maze is symmetrical, 

you could — if you are clever — avoid some walls by 
remembering what your opponent has done. You 
could also change the ending point of the maze 
generation when it reaches the top or bottom row 
instead of a corner. For the more advanced, you could 
generate the mazes by hand, or another program, and 
store several of them in a file and pick the one to use 
at random. This would ensure a much greater variety 
of mazes, and allow you to make quite complex ones, 
but beware of making them too complex. 


] 
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D To square B | 
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| +9 A | 
| 
| | Bits in the variable “Matrix” 
l 
1D To square B | 
} 1 
: | 
| | 0 = Blocked 
1 = Blocked 
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Agame in action; all walls are hidden 


140. 

141. def mazeGen(): 

142. global maze, current, last, tilePlan, playPos, 
refresh 

143. refresh = True 

144. maskTo = [2,8,4,1] 

145. thisTile = random.randint(@,14) 

146. thisMethod = random.randint(@, 3) 

147. for s in range(@,nSquares): 

148. maze[s] = @ # clear the maze 

149. if thisMethod == @: 

15e. tilePlan[s] = random.randint(@,14) # random 
tile 

151. if thisMethod == 1: 

aleve tilePlan[s] = s % 10 # diagonal lines 

153. if thisMethod == 2: 

154. tilePlan[s] = thisTile # all the same but 
different for each maze 

q557. if thisMethod == 3: 

156. tilePlan[s] = s % 12 # offset lines 

157. maze[centre] = 15 

158. current = centre ; last = centre 

159. while not(current == @ or current == 8): 

160. blocked = True 

161. while blocked: 

162. move = random.randint(@, 3) 

163. direction = dirInc[move] # initial direction 
of move 

164. test = direction + current 

165. if test >= @ and test <= (nSquares/2 +gSide/2) 
and test != last: # within the board 

166. if not(direction ==1 and current % gSide == 
gSide-1) and not(direction ==-1 and current % gSide == 
Q): 

167. blocked = False 

168. maze[last] = maze[last] | maskFrom[move] 
# clear exit square 

169. maze[nSquares-last-1] = swap(maze[last]) 

170. current = test 

171. last = current 

i726 maze[current] = maze[current] | 
maskTo[move] # clear entrance square 

73 maze[nSquares-current-1] = 
swap(maze[current]) #need to swap bits 

174. playPos[9] = current # player start positions 

175i. playPos[1] = nSquares - 1 - current 

176. playPos[2] = playPos[®@] ; playPos[3] = playPos[1i] # 
start positions 

177. 

178. def movePlayer(pn, inc): 

179. global refresh, playPos, done 

180. refresh = True 

181. fromSq = playPos[pn] 

182. playPos[pn] += dirInc[inc] 

183. if not(maze[fromSq] & maskFrom[inc]) : # a wall in 
the way 

184. playPos[pn] = playPos[pn+2] # back to start 

185. resetPlayer[pn].play() # reset noise 

186. if playPos[pn] == centre : # winner 
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187. finish. play() 
188. refresh = False 
189. drawScreen(True) 
190. done = True 

191. 


192. def getMove(): 


193. global joyLast 

194. joyNow = [-1,-1,-1,-1] # no move 

195. for nun in range(@,2): # read both nunchucks 

196. x = nun 

197. y = 2+nun 

198. bank = readNck(nun) 

199. if bank[@] > 190: 

200. joyNow[x] = 1 # move right 

201. if bank[@] < 60: 

202. joyNow[x] = @ # move left 

203. if bank[1] > 190: 

204. joyNow[y] = 2 # move up 

205. if bank[1] < 60: 

206. joyNow[y] = 3 # move down 

207. if joyNow[x] != joyLast[x] and joyNow[x] > -1: 
208. movePlayer(nun, joyNow[x]) # move left or right 
209. if joyNow[y] != joyLast[y] and joyNow[y] > 1: 
210. movePlayer(nun, joyNow[y]) # move up or down 
211. joyLast[x] = joyNow[x] 

212. joyLast[y] = joyNow[y] 

213). 


214. def swap(value): 


215. result = (value & 1) << 2 | (value & 4) >>2 | 
(value & 2) << 2 | (value & 8) >> 2 

216. return result 

PAAlg) 


218. def terminate(): # close down the program 


219. print ("Closing down please wait") 

228. pygame.mixer.quit() 

Papi pygame.quit() # close pygame 

222. os._exit(1) 

223% 

224. def checkForEvent(): # see if we need to quit 
225. global refresh 

226. event = pygame.event.poll() 

22Tze if event.type == pygame.QUIT : 

228. terminate() 

229. getMove() 

230. if event.type == pygame.KEYDOWN : 

231. if event.key == pygame.K_ESCAPE : 

232% terminate() 

233% getMove() 

234. if event.key == pygame.K_g : #glimpse maze walls 
235. drawScreen(True) 

236. time.sleep(2.0) # time to display 
2377. refresh = True # draw over it 

238. 


239. # Main program logic: 
240. if _name_ == ' 
241. main() 


__main_': 
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MAKE A TALKING 
WEB BROWSER 


For blind people, the internet is at best a challenge. 
With some modifications, the Raspberry Pi can read text content to them 


ow can the internet can be made accessible fill in forms, download music, or listen to the BBC’s 
to those with no sight? Here’s a browser — iPlayer or anything like that. It’s just dandy with 
albeit limited to reading text content — which Wikipedia, though. 


is dedicated to the blind user. Given an internet 
connection, the user has only to enter a search term, use Software setup 


Mechanize up and down cursor keys to select a link, press RETURN, Use the following commands to install the necessary 
ae ana and press CTRL#R to start and stop reading the text. All software in the Terminal or command line: 
2GAhggo this in a Raspberry Pi - anda keyboard, a power supply, 
eSpeak Python and a pair of earphones. That’s right: no screen! sudo apt-get install python-qt4 
package sudo easy_install mechanize 
oolong Before we start sudo apt-get install python-bs4 
ee Note that this browser only reads text from webpages. sudo apt-get install espeak 
Headphones You can enter search terms, you can go to headers or 
links, you can find text within the page. But you can’t Download and unzip the TWB directory from 
magpi.cc/aAIDCi. 
ge” sities Put the TWB directory in the /home/pi/ directory. 
~ Add@sh /home/pi/StartTWB.sh to the 
x i ~/.config/lxsession/LXDE-pi/autostart file. 
~ Put the following in the StartTWB.sh file in 
yA the /home/pi/ directory: 
Ma J aa 
/ ““ f — Shown here in 
( pA Y f a soft case, the 
7 —— Raspberry Pi 
LZ = converts text 
to speech 


The user can 
listen to webpage 
text through Ae ae : : 


headphones ) (a=) (ane (eee) A keyboard is used to 


navigate pages with 
spoken feedback; no 
need for a monitor 
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An outer case may be used to protect the Raspberry Pi 


#!/bin/bash 

MYPATH=' /home/pi/TWB/' 
MYPROG=' twb. py’ 

cd $MYPATH 

sudo /usr/bin/python $MYPATH$MYPROG 


If you want to connect to a wireless LAN, you’ll need a 
screen and mouse to set up the connection (just once). 


Summary of commands 
At startup, you’ll be prompted for a web search term. 

Note: to delete a letter, press the BACKSPACE key, 
not the DELETE key. If you’d rather use the DELETE 
key, look for the # CHOOSE DELETE KEY HERE # line 
in the Main.py file, and comment/uncomment the 
appropriate line. 

Press RETURN to start the search. You’!l hear “The 
first link is...” and the first link. The up and down 
cursor (arrow) keys will announce the other links: 
keep holding the cursor key down to hear the text in 
its entirety, or release it and press again to move on to 
the next link. 

When you’ve found a link to follow, press RETURN 
and wait to hear “Ready”. Press CTRL+R to start 
speaking; press it again to stop. While speech is 


stopped, press CTRL+H to list headers, use cursor keys 


to hear them, and RETURN to select one. 

Similarly, CTRL+L lists links on the page; again, use 
cursor and RETURN keys to select one. If you can’t 
find a useful header or link, press ESC and you’|l be 
returned to the read mode. To find text on the page, 
press CTRL+F and enter the search text. Repeated 
presses of CTRL+F will find later occurrences of the 
text, or allow entry of a different search term. 

When not reading, the right and left cursor keys 
move forward and backwards by a word, speaking 
the word, from the beginning of the sentence being 
spoken. SHIFT + left cursor moves back a sentence; 
SHIFT + right cursor moves forward a sentence. 

CTRL+S lets you enter a web search term. In any 
mode, CTRL + up cursor will increase the volume, and 
CTRL + down cursor will reduce it. Similarly, SHIFT + 
up cursor will increase the speed, and SHIFT + down 
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cursor will decrease it. To close down the browser, 
press SHIFT+CTRL+Z. 


Under the bonnet 

When entering a web search string (or looking for 

text on a webpage), the key pressed is spoken — for 
speed, we store WAV files for each letter — hence the 
Sounds directory. A powerful module called Mechanize 
simplifies access to the web, in particular making it 
easy to extract links and go to those links. Having 
downloaded HTML from a site, we add markers to 
identify headers, and insert ‘.’ at line, paragraph, 

and table HTML codes. The Beautiful Soup module 
helps with extracting text. We split the text into a list, 
breaking wherever there is a ‘.’. This presents the text as 
a series of, well, let’s call them sentences. The text of a 
webpage is spoken using the eSpeak speech synthesizer. 

Ideally, we’d set eSpeak going, speaking text, and 
stop it if we missed a word, back up a few words, 
and listen again. Unfortunately, this seems to be 
impossible with eSpeak on a Raspberry Pi: the sound 
breaks up and becomes unintelligible after a few 
seconds. Could we write the eSpeak output to a file 
and play the file? Yes, but if we send all the text from 
a webpage to such a file then that leaves no way 
of knowing where in the text we’ve stopped: if we 
wanted to hear a word again, we’d have to plough 
through all the stuff that’s already been spoken. 

That is why we break the text into sentences. We can 
stop — and restart — the text at any point. If we want to 
hear a word again, stop the speech and the right cursor 
key will speak words, starting at the beginning of the 
current sentence. 


The Raspberry Pi handles the conversion of text in webpages to speech 
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BILL BALLARD 


Billis a retired physicist and former 
Radiological/ Nuclear Countermeasures 
Program Manager who got back to his 
programming roots to find fun things to 
do with his ten Raspberry Pis. 
github.com/wpballa 


SIMPLE PI 
= DISPLAY 


2ejN6sk 


> MightyOhm 


een § This project connects a MightyOhm Geiger counter to a Pimoroni 


maneweees Scroll pHAT display for real-time radiation measurements 
2Gc4CNT 
> Geiger counter he MightyOhm Geiger counter is a great DIY immediately. Initialise Raspbian with raspi-config 
case to protect project, and there is a simple way to connect to the proper Internationalisation Options (time 
chaise it to a Raspberry Pi for data logging and zone, keyboard, wireless country code, etc.), change 
magpi.cc/ displaying with a Pimoroni Scroll pHAT. The code the default password, and set the host name in 
2GejFgU supports either the newer HD Scroll pHAT or the older Advanced Options to something like ‘geiger’. Make 
> 5V USB power version with a simple variable change at the start of sure that you enable 12C in the Advanced Options 
supply the Python program. of raspi-config, and SSH if you will be connecting 
> Pimoroni Scroll remotely. Next, edit: 
pHAT HD Software setup 
don leraea Download and install the latest version of Raspbian sudo nano /boot/cmdline.txt 
Lite (magpi.cc/2ejN6sk) on your microSD card using 
any of the excellent instructions in the Raspberry ...and remove: 
Pi Forum. If you copy your wpa_supplicant.conf 
file to the boot partition before the first startup, console=serial@, 115300 


your wireless network connection will be active 
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You can use either 
an original Scroll 
PHAT or an HD one 


The assembled 
Geiger counter 
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...from the line. Save, then exit the file and reboot geiger.py 
the Raspberry Pi. Now you should do the usual update >PYTHON 3 
and upgrade to the operating system: #! /usr/bin/python3 
DOWNLOAD: 
sudo apt-get update && sudo apt-get # set this line according to your version of magplec’ar oda 
upgrade -y the scroll pHAT 
HD = True’ # set to true for HD version, false for old version 
Next, install the Python pip and scrollphathd import serial 
applications (just leave off the ‘hd’ if using an older import time 
Scroll pHAT): if (HD): 
import scrollphathd 
sudo apt-get install python3-pip from scrollphathd.fonts import font5x7 
python3-scrollphathd else: 
import scrollphat 
Finally, install pySerial and flask: fname = "/home/pi/geiger.csv" 
# open the mightyohm geiger counter terminal 
sudo pip3 install pySerial flask ser = serial.Serial('/dev/ttyAMAQ', baudrate=9600) 
# initialize scrollphathd or scrollphat 
...and you are all set. if (HD): 
Download the geiger.py file from GitHub scrollphathd.set_brightness(@.2) 
(magpi.cc/2Foqfzl) and customise it for your desired scrollphathd. rotate(180) 
log file location and your Scroll pHAT version (HD = scrollphathd.clear() 
True or False). else: 
scrollphat.set_brightness(32) 
Hardware setup scrollphat.set_rotate(True) 
Assuming you have already assembled the Geiger scrollphat.clear() 
counter with the MightyOhm instructions, you # read each line of input, reformat byte to string and write to file 
only need to solder the header to the Scroll pHAT while True: 
and connect a few wires. Optionally, you can use cByE 
an extra-tall 2x20 stacking header so you can use lin=ser.readline() 
a connector. To connect the pHAT to the Raspberry line=lin.decode(‘utf-8').split(',') 
Pi, you need to solder three wires to the Scroll pHAT outs = line[5] + line[4] 
corresponding to GPIO physical pins 6, 8, and 10. if (HD) : 
Pin 6 (GND) connects to the Geiger counter’s J7 scrollphathd.clear() 
connector pin 2, pin 8 (GPIO 14) connects to the J7 scrollphathd.write_string(outs, x=1, y=9, font=font5x7) 
pin 4, and pin 10 (GPIO 15) connects to the J7 pin 5. (buf1, buf2) = scrollphathd.get buffer _shape() 
Feel free to use a connector rather than direct wiring. for i in range(buf1): 
scrollphathd. show() 
Run it scrollphathd.scroll() 
Connect the Pi to power, then turn on the Geiger time.sleep(@.1) 
counter (mute it if you wish, using the push-button). else: 
Log in and launch the program with: scrollphat.clear() 
scrollphat.write_string(outs, 11) 
python3 geiger.py & len = scrollphat.buffer_len() 
for i in range (len): 
The display should start showing the uncalibrated scrollphat.scroll() 
radiation level in microsieverts per hour, scrolling time.sleep(@.1) 
across the screen until you kill the process using: # now write to file, close each time in case you stop the program 
geig = open(fname, ‘a') 
kill -9 PID geig.write(lin.decode(‘utf-8')) 
geig.close() 
...where PID was the number shown when you except (Keyboardinterrupt, SystemError, SystemExit): 
initially launched the program. Alternatively, if (HD): 
you can use: scrollphathd.clear() 
else: 
ps -ef | grep geiger scrollphat.clear() 
geig.close() 
...to find the PID of the geiger.py process. ser.close() 
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NEVER 
BLAME THE 


MACHINE... 


Let's be 
square(ish) 


BRIAN BEUKEN 


Very old game programmer now 
teaching very young game programmers 
a lot of bad habits at Breda University of 
Applied Science in Breda NL. 
scratchpadgames.net 


ON THE RASPBERRY PI 


> Code::Blocks 
sudo apt- 


get install 
codeblocks 


>STB 
magpi.cc/ 
2GCQe19 


> Apretty picture; 
not too big 


PART 03 


After our setup of systems, it’s time to get some graphics sorted out 


e had to plough through a lot of tech stuff last 
time, but we still have a tiny bit more to do 
and need to make a few additions so we can 
start to build up a framework for a game. You should 
be comfortable with objects now, and it’s time to use 
some code concepts to control them and create a basic 
code framework that will evolve into a playable game. 
Last time we bounced a couple of triangles around, 
but triangles are not much use for games. We need 
to be able to move variable-sized objects around and 
have some control over the graphics they present us 
with to make our games fun and interesting. 
But wait, all this tech is overwhelming. So far we 
haven’t really learned much about code, so it’s time to 
explain some of that and go through what we did last 
time so we can expand on it. 
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Time for some C/C++ foundations 
All programming, regardless of the language, is 
about manipulating data, usually represented by 
variables, based on various conditions or needs, and 
in turn acting on that data to create other conditions 
or needs. 
CPUs do that by simply performing one instruction 
at a time and then passing control to the next 
instruction; an instruction could be something which 
changes, inspects, or stores selected variables and 
then continues to the next instruction in line, or 
passes control to a different set of instructions. 

In C/C++, instructions can be singular, like: 


wae &) & alg 
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Or grouped, using {} braces: 


{ 

Int a = 13; 
Int b = 2; 
Int c = a+b; 
a 


Groupings make more sense when we want to doa 
number of different things following a test. Braces {} 
will become both your friend and your enemy — as will 
the ; at the end of an instruction, which is ‘nearly’ 
always needed. 

Both these singular and grouped instruction 
examples are setting up integer-type variables, and 
putting values into them. C/C++ insists you let it know 
what type of variable you are creating so it can be sure 
you put the right type into it — it’11 usually complain 
if you don’t! For now, we will use int and float; int 
types are for integer whole numbers, and float types 
are for more precise floating point numbers like pi: 


float Pi = 3.14159265f; 


Variables generally should be named something 
appropriate to their function. For example: 


int MyAge = 54; 
... makes more sense when reading it back than: 
int ma = 54; 

It’s up to you what names you use, but generally it’s 
best to make variables describe what they are holding. 
There is no limit on the size of your variable names, so: 
int I_will_be_this_age_next_birthday = 


MyAge + 1; 


...1S valid, but will get you some funny looks at a 
code review. 


Magazine 
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Figure 2 A familiar graphic 
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Not too much to remember 

There aren’t actually many instructions in the C/C++ 
language, but it does have a lot of very specific rules 
on how to use them. We’1I stick with the simpler 
ideas to begin with, and expand our understanding 
as we need to. 

When last time we added a Speed variable to our 
Xpos variable, we were able to test the resulting 
new position of our object and decide if we make 
a change to our Speed value, or not. A choice was 
made based on a condition test. We asked a simple 
question: if the Xpos is bigger (or less) than the 
value representing the edge of the screen, (then) do 
something to alter the direction, in this case negate 
the speed we move. 

If, then, else concepts are important to most 
languages, even if they don’t have the ‘then’ 


MagPiHelloTriangle. 
cpp, 
SimpleObj.h/cpp, 
Game.h/cpp, 
OGL.h/cpp 


DOWNLOAD: 
magpi.cc/2suLVC2 


If, then, else concepts are 
important to most languages, 
even if they don't have the ‘then’ 


keyword; C/C++ does not actually have that word, but 
it’s helpful to think it when you are writing code. It 
lets us make decisions based on the resulting truth or 
otherwise of a test. 

How did that decision process make an entire 
triangle move? Well, it didn’t: it made a reference 
point at the centre of that triangle move, and we 
simply told our GPU to build a triangle around that 
X,Y co-ordinate. We were able to abstract the concept 
of the triangle, down to one single point and modify 
that with simple arithmetic, adding a + or — speed to 
move it on each update. 

So there are a few basic principles we should be 
able to get our head around from that. 


Assignment: where we store a value into 
a variable. 
Manipulation: where we modify the value 


of a variable. 

Condition checks: where we test variables and 
potentially change the sequential 
flow of our program. 


These are great foundations, but because a 
program usually goes from one instruction to the 
next, it will eventually reach the end of the code. 
That’s where some special flow control methods 
we call loops come in. We’ve seen one type of so far 
unexplained loop, the for loop, which we used to 
repeat our updates. 

A for loop, when set up, is given a counter variable, 
with an initial value, which it then automatically 
modifies at the end of each loop. It then compares 
the counter to see if the condition also stated in the 


TYPE 
CAREFULLY 


Typing slowly 
and carefully 
forces you to 


think about 
what you 
enter, and 
helps you 
to manage 
your code. 
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USE 
SENSIBLE 
VARIABLE 
NAMES 


A variable that 
explains its 
own function is 
easier to keep 
track of. 


for declaration is still true. If not, it exits the loop, 
otherwise it starts again, this time with the new 
value in the counter. 

So: 


for (int a =@; a<2@; a++) 
{ /* this is the start of the loop*/ 

//.. do any amount of stuff between the {} 
}/* the end brace is the end of the loop*/ 


... just makes the loop start at o (int a=@), and at 
the end of each loop it will increment a (a++) until 
such time as a is no longer less than 20 (a<2@). 

How that counter is modified is up to us, but 
usually we just settle for a simple increment a++, 


Triangles might be cute, but theyre 
not a lot of use for games. We need 
something more functional 


Figure 3 
With or without 
texture 


or decrement a--, which allows us to use the counter 


as a handy index to lists of things we want to process. 


The code between brackets can be anything at all. 
Here it will repeat 20 times with this formatting and 
give us the ability, if we want it, to use the a variable 
for different things, each time being a value 1 more 
than the last time; we call this iteration. 

There are a couple of other types of loop; we’ll 
discuss them as we need them. For the meantime 
a for loop is simple to understand, and we will use 
it often. 


Being able to test things and choose the next set 
of instructions we do is an important concept. This 
is what gives us program flow control and it’s crucial 
to getting computers to do what we want them to 
do and change the sequence of instructions we want 
to follow. 

All these concepts are easier to visualise when we 
can see some actual result on screen, but triangles 
are not quite what we need — let’s expand our 
graphical abilities a bit more. 


Time to get square 

Triangles might be cute, but they’re not a lot of use 
for games. We need something more functional, so 
we’ll build our first games from two basic concepts: 
sprites and tiles. 

Both are essentially square objects, which can be 
made from two right-angled triangles. Tiles can be 
used to create a background, and sprites can be used 
to represent our objects/players moving around. 
We’ll focus on tiles this time. 

Let’s make a pretty simple change to our current 
Lesson 2 system, So we just send two triangles to 
the GPU and ask it to draw them as a square. In 
your SimplObj.cpp file, change the contents of 
TriVertices to this: 


static const GLfloat TriVertices [] = 
{ 0.1,0.1,0.0, -0.1,0.1,0.0, 0.1,- 
@.1,0.0, -@.1,0.1,0.0, -0.1,-0.1,0.0, 
@.1,-0.1,0.0, }; 
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Tutorial 


relticcirn® ret 


OF a yrs — 


aon Vos cone 


You should see there are now six points/vertices 
representing the tips of two right-angled triangles, 
some of them duplicates — we’ll cover that later. 

And also, in the Draw method, change the 
glDrawArrays to now draw Six vertices. Compile 
and run. 

Nice, we have red squares (well, squarish), as in 
Figure 1; it’s half-way there. Next we need to make 


those squares into some kind of recognisable graphic. 


We can’t really do that in the Lesson 2 code without a 
large listing, so let’s get hold of Lesson 3 code, which 
will now load some graphics for us (Figure 2), create 
textures (Figure 3), and let us put a simple image on 
screen (Figure 4). 


Loading graphics 
Images are funny things; they come in many formats 
and resolutions, but for use as graphics in our games 
we need them in very raw byte-for-byte formats. That 
requires us to load the funny formats and convert 
them into raw data ready for OpenGL ES 2.0 to turn 
into a texture for display. That’s quite a chore that 
most sane coders avoid, so we need some help with it. 

Notice in the new OGL.cpp file that we also adda 
new header, called stb_image.h, which is a helper 
system that will let us load and convert images. We 
can largely ignore how it does what it does, just be 
confident that it does what we need it to do. It’s part 
of several helper systems collectively known as STB, 
from coder Sean T Barrett, and is public domain so 
anyone can use them. See the ‘You’1!] Need’ box on 
the first page! 

Let Git do its thing and you will now have a new 
directory called, unsurprisingly, STB, and in there 
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will be the stb_image.h file we need. You can 
choose to copy it to your working directories, or just 
leave it there and make sure that Code::Blocks adds 
/home/pi/stb to its list of directories, as we have in 
the Lesson 3 project files for you. 


A new initialisation 

Looking at Lesson 3’s source, you can see OGL has 
been adapted to load a familiar image and turn 

it into a texture. The shaders are also adapted 

to use that texture. Take a look again at the 
TriVerticesWithTex list in SimpleObj.cpp and you 
will see some more small changes and explanations 
in code. 

It’s still all a bit hard-coded, making it inflexible, 
but for tutorial purposes we can now see that we 
are able to draw a new kind of textured object. Now 
SimpleObj is able to display graphics! 

So far so good, it’s still not very elegant code, 
but we have managed to put our graphics on screen 
with very little effort. We could put a lot of them on, 
creating multiple instances of a SimpleObj. But 100 
squares with the same graphics isn’t fun. Next time 
we need to add some flexibility to load and control 
more graphics and have them do different things. 


LEARN TO CODE WITH C 


Enjoying using C and C++ and can't wait until next 
month for more? Check out our Essentials book, 
Learn to Code with C, for more C tutorials for 


beginners: magpi.cc/learn-c-book 


Figure 4 
And now we can 
draw images 


TRY YOUR 
OWN IMAGES 


You can use 
almost any 
image, but 


keep it below 
1024x1024 
pixels. PNG is, 
we believe, 
probably your 
best option. 
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> PC (desktop or 
laptop running 
Windows, Mac 
or Linux) 


> Pi Zero (any 
model) with 
GPIO header 


> Debian Stretch 
with Raspberry 
Pi Desktop on 
USB stick 
rpf.io/x86 


> micro USB 
cable or Pi Zero 
USB Stem 
magpi.cc/ 
2Gb2d67 


> LEDs and 
a button 


> 3D Xmas Tree 
magpi.cc/ 
2GewFwe 


> SnowPi 
magpi.cc/ 
2GdupFA 


Asa 

Christmas 
decoration, we 
used the Pi Hut 

3D Xmas Tree and 
Ryanteck SnowPi 
boards together by 
plugging a Pi Zero 
into a Pi3 


PI ZERO 


BEN NUTTALL 


Raspberry Pi’s Community Manager, 
creator or the GPIO Zero library, 
and the Foundation's resident 
Python expert. 
twitter.com/ben_nuttall 


This laptop is running the 
Raspberry Pi Desktop x86 OS 


The pinout command-line tool 
is a handy reference guide to 
the Raspberry Pi's GPIO pins 


The Pi Zero is connected using 
a short micro USB cable only 


Access the GPIO pins on a Pi Zero from your PC, 
or double the available GPIOs on a Pi 3! 


he latest release of the Raspberry Pi Desktop 

x86 operating system alongside Raspbian 

Stretch for Raspberry Pi includes a new GPIO 
expander tool. Now you can easily run GPIO programs 
from your PC by simply plugging in a Pi Zero witha 
single USB cable and no SD card is required. It’s handy 
for prototyping, and can be really useful in coding 
clubs, libraries, and schools where the conventional 
Pi setup isn’t possible. It has limitations, but it’s ideal 
for lots of GPIO projects, such as many of the GPIO 
Zero ones you’ ll find in The MagPi. 

The GPIO expander tool means you can connect a Pi 
Zero (original, W, or WH) to a regular PC with just a 
micro USB cable, no SD card required, and control the 
GPIO pins. The easiest way to get it working is by live- 
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booting the Raspberry Pi Desktop x86 OS on your PC. 
Remember, when live-booting, once you shut down, 
just remove the USB stick and you can return to your 
usual operating system and get back to your boring 
spreadsheets or whatever. 

Boot into the Stretch release of Raspberry Pi 
Desktop, which comes with everything you need, 
ready to go. Plug in your Pi Zero and you’ll be 
prompted to select a role for the device. Select ‘GPIO 
expansion board’ and continue. It will take 30 seconds 
or so to flash it, then the dialogue will disappear. 

Once the dialogue disappears, that means your 
Pi Zero is ready. Try pinging it just to be sure it’s 
connected. Open a Terminal and type: 


ping6 fe8@: :1%usbe 


This is the Pi Zero’s IPv6 address. You should see some 
responses, so press CTRL+C to stop pinging. If you can’t 
connect to it, try plugging it back in and trying again. 
You’ll need to define two environment variables to set 
this as the default route for GPIO commands. Type: 


leafpad .bashrc & 
This will open a simple notepad editor with your 


user’s Bash configuration. Scroll to the bottom and, 
on new lines, add: 
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export GPIOZERO_PIN_FACTORY=pigpio 
export PIGPIO_ADDR=fe8@: :1%usb@ 


Save the file and close it. Now close the Terminal 
window and open up a Python editor or shell (such as 
Thonny or IDLE). Connect up an LED or a simple LED 
board like a Pi-Stop, and write the following code to 
flash a single LED (you’1l need to know which GPIO pin 
number it’s connected to — we’re using GPIO 17): 


from gpiozero import LED 
led = LED(17) 
led. blink() 


You should see the LED on the Pi Zero blink on and 
off continuously. That’s just the start! Take a look at 
the GPIO Zero documentation (magpi.cc/2qd2MEb), 
as well as plenty of tutorials in The MagPi for lots of 
different projects you can do with GPIO Zero. 


Using two Pi devices together 
As well as using GPIOs from your PC, you can connect 
a Pi Zero to another Raspberry Pi and use two sets of 
GPIOs together, controlled within the same script. 
This is similar to the principle of remote GPIO, which 
was covered in issue #60, but instead of using Pi 
devices over a LAN (local area network), where each 
Pi has to be running Raspbian from an SD card, this 
method again just requires a Pi Zero and a USB cable. 
Now boot a Raspberry Pi (e.g. a Pi 3) running the 
latest Raspbian Stretch. The Pi Zero tool is not pre- 
installed in Raspbian, so you’ll need to install it. Open 
a Terminal and type: 


sudo apt install usbbootgui -y 


When it’s booted, connect a Pi Zero with a USB cable 
and this time, instead of setting the default pigpio 
address and pin factory, you’ll define that within the 
code. Open a Python editor and type out: 


from gpiozero import LED, Button 
from gpiozero.pins.pigpio import 
PiGPIOFactory 

from signal import pause 


pizero = PiGPIOFactory('fe8@: :1%usbe' ) 


btn 
led 


Button(17) # button on Pi 3 
LED(17, pin_factory=pizero) 
# led on pi zero 


led.source = btn.values 
pause() 


Here you have a button connected to GPIO 17 on the 
Pi 3, and an LED connected to GPIO 17 on the Pi Zero, 
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P| ZERO GPIO EXPANDER 


which is connected 


i ARascs via a USB cable. When 
t the button is pressed, 
Pueene select (he rote you werk i to have 


the LED lights up. 
b 


- simplest of examples, 
t 


>PYTHON 


NAME: 
tree_sp_2.py 


DOWNLOAD: 


pe rree ut it demonstrates rpf.io/xmascode 
he principle of 
controlling devices 
attached to two 
different Pis. 

A better use for this 
would be to use two 
HATs or other add-on 
boards which use the 
whole pin header; for example, the Pi Hut 3D Xmas 
Tree and the Ryanteck SnowPi. The Christmas tree 
uses all available GPIO pins for its LEDs, and SnowPi 
uses nine of its own. But of course, you can simply 
place one board on the Pi 3, and another on the Pi 
Zero and when creating the relevant GPIO Zero device 
objects, use the remote pin factory for one: 


memen Der (eletix 


Above When you plug in a Pi Zero, 
you'll be prompted to use it asa 
GPIO expansion board 


tree = LEDBoard(*range(2, 28)) 
sp = SnowPi(pwm=True, pin_factory=pizero) 


If you want to run a Python script on boot (using 
@reboot in cron), there’s a trick you can use to wait 
for the Pi Zero to be booted over USB before you try 
to control it. The PiGPIOFactory connection will 
fail with an OSError if the Pi Zero is not available, 
so you can just keep trying that until it works using 
a try/except block: 


pizero = None 
while not pizero: 
try: 
pizero = PiGPIOFactory('fe80: :1%usbe' ) 
except OSError: 
sleep(1) INSTALLATION 


GUIDE 


Discover 
how to install 
Raspberry Pi 
Desktop on 

a Mac or PC 
in The MagPi 
issue #60. 

Or watch our 
installation 


... then proceed to create the SnowPi object on the 
pizero pin factory. 

As you can see in our final code, we turn the tree 
star LED on, have the tree’s red LEDs randomly 
flicker, and have the SnowPi’s LEDs blink on and off. 


USB MAGIC 


The Pi Zero features a USB OTG (on-the-go) port, 
allowing you to boot over USB from a PC. Your 


video online 


magpi.cc/ 
2wkkThL 


PC sends the required boot firmware to the Pi 

over the USB cable, launching a mini version of 
Raspbian and booting it in RAM. The OS then starts 
the pigpio daemon, allowing ‘remote’ access over 
the USB cable. 
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YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


OLD 


HARDWARE 


Use it elsewhere 

The original Raspberry Pi, while nowhere near as 
powerful as a Pi 3, is still no slouch at many computing 
tasks. If you’re not using it for experimenting with 
projects, you can always turn it into a file server, or 
just use it for testing out simple circuits using Python. 


Give it to aq young maker 

Know a child interested in computing but hasn’t been 
introduced to Raspberry Pi yet? Gifting one might be 
the beginning of a long career in software engineering 
or otherwise. It would also give them a leg up on 
computer science lessons at school. 


Recycle 

Literally can’t find a use for your Raspberry Pi? No 

one you can gift it toe No room to keep it? Do the 
responsible thing and sell it, or recycle it with an 
electronics recycler so the parts can go towards making 
other electronics without contributing to landfill. 


In general 

Python is standard, and the GPIO pins (however 
many you have) all work the same way, so 
coding with the original Raspberry Pi is the 
same as programming with a Pi 3 or Pi Zero W. 
Even Minecraft Pi and Scratch 1.4 work on older 
Raspberry Pi models just fine. 
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NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Scratch 2.0 

Unfortunately, Scratch 2.0 requires you to use a newer 
Raspberry Pi as it requires a lot of resources compared 
to Scratch 1.4. You can still use Scratch 2.0 on a web 
browser on your home computer, though. 


HATs 

HATs are backwards compatible with even the Pi B+ and 
A+, but not a Raspberry Pi with 26 GPIO pins like the 
original Model B and Model A. We still see some add-ons 
that use 26 pins to attach to the Raspberry Pi, though. 


Can | buy older models? 

Yes! You can get brand new Model A+, Model B+, and 
Raspberry Pi 2 boards. We’ve also seen stock of Pi Zero 
v1.3 boards on Adafruit. They all tend to be priced low, 
although it does depend on where you shop. 


Why would | want an older model? 

Your needs may require a smaller Raspberry Pi (like 

the Model A+) or for your project to draw a little less 
power than a Raspberry Pi 3. You may even like the 
bulk-buy discount on the cheaper Pi boards. While we 
recommend getting a Raspberry Pi 3, that doesn’t cover 
all cases. 


Buying used Raspberry Pis 

Like buying anything used, you need to understand the 
risks. Luckily, eBay has good buyer protection these 
days so if a Raspberry Pi you buy doesn’t meet the 
description on the listing, then you should be able to 
get some money back. Raspberry Pi boards are fairly 
hardy, though, so you’re unlikely to come across many 
faulty units. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT HARDWARE INTERFACES DOES IT HAVE? 

Depending on the model, the Raspberry Pi has either 40 or 26 
dedicated GPIO pins. In all cases, these include a UART, an I?C bus, 
an SPI bus with two chip selects, I?S audio, 3V3, 5V, and ground. 

The maximum number of GPIOs can theoretically be indefinitely 
expanded by making use of the I?C or SPI bus. There is also a 
dedicated CSI-2 port for the Raspberry Pi Camera Module, and a DSI 
display port for the Raspberry Pi LCD touchscreen display. 


WHY IS THERE NO REAL-TIME CLOCK (RTC)? 

The expectation is that non-network-connected units will have their 
clocks updated manually at startup. Adding an RTC is expensive 
once you factor in batteries, area, and components, and would have 
pushed us above our target price. You can add one yourself using 
the GPIO pins if you'd like an interesting electronics project. 


CAN | ADD EXTRA MEMORY? 
No. The RAM on the Model A, A+, B, B+, and Zero is a package 
on package (POP) on top of the system on chip (SoC), so it is not 


removable or swappable. The RAM on the Pi 2 and 3 Model B 
versions is on a separate chip on the bottom of the PCB, but 1GB 
is the maximum RAM that the SoC used by the Pi 2 and 3 Model B 
versions can support. 


WHY DOESN'T THE RASPBERRY PI INCLUDE A CERTAIN PIECE OF 
HARDWARE OR A CERTAIN SORT OF PORT? 

Our main aim is a charitable one: we are trying to build the 
cheapest possible computer that provides a certain basic level of 
functionality, and keeping the price low means we've had to make 
hard decisions about what hardware and interfaces to include. 


WHAT IS ITS OPERATING TEMPERATURE? 

The Raspberry Pi is built from commercial chips which are qualified 
to different temperature ranges; the LANg514 (LANg512 on older 
models with two USB ports) is specified by the manufacturers as 
being qualified from 0°C to 70°C, while the SoC is from -40°C to 85°C. 
You may find that the board will work outside those temperatures, 
but we're not qualifying the board itself to these extremes. 


INTRODUCING THE HOTTEST 
NEW PRODUCTS FOR YOUR PI 
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feature 
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B ri V | cy | n d D igital security is very important. With recent 


revelations over how people can exploit the 
vast majority of modern processors to access 


LS a C u r i ty a] n your private data, it’s never been more important 
p 


to learn how to improve your online security. While 
the Raspberry Pi may be immune to Spectre and 


7 Meltdown, it doesn’t mean you shouldn’t improve 
and with, your your own security. 


So in this article, we’ll help you to protect 


R b p - yourselves from nasty folks online, and even show 
| S p e i ry I how your Raspberry Pi can help you in this effort. 
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abil 
BASICS OF 
SECURITY 


Before we secure your Pi, make sure 


PASSWORD 
E TOUR ese 


LEARN HOW TO CREATE 

A STRONG PASSWORD 

We could write pages on 
this, so instead we'll point 
you towards this great guide: 


feature 


Password 


TURN ON TWO-FACTOR 
AUTHENTICATION 

It may be a pain, but it means that 
even if someone works out your 
password, your more important 


magpi.cc/2rxYHcb. accounts will be safe. 


to follow these basic security tenets 
DON'T REUSE PASSWORDS 

If one password is compromised, 
then all your accounts with that 
password are. 


GET A PASSWORD MANAGER 
Services like 1Password 
(apassword.com) and KeePass 
(keepass.info) allow you to use 
unique, machine-generated 
passwords on accounts that 
you can then unlock with a 
master password. 


he most secure computer and network in the 
world won’t be much use if your passwords 
can be cracked because you used password1 
everywhere. Here’s a refresher on how to keep your 
online presence safe. 


ONLINE 


DON'T USE DICTIONARY WORDS 
It might be common sense, but 
common cracking techniques 
start with dictionary words. 

BE PREPARED TO CHANGE IT 
While the current school 

of thought is not to update 
passwords every 90 days any 
more, you may still need to 
change a password if there's 
a security leak or similar. 


DON'T USE A COMMON 
PASSWORD 

Check this list to make sure 
you're not doing anything silly: 
magpi.cc/ 2rXjFl2. 


TWEAK YOUR PRIVACY SETTINGS 

Facebook, Twitter, and other social media services 
let you change the privacy of certain account 
aspects. Make as Little public as possible. 


aoleattany peice tient tiontantentantantantantantantestantantentantentetedtadtestonts stetteatientientientien 


LIMIT APP ACCESS TO YOUR ACCOUNTS 


I I 
Some places let you log in via Facebook or Twitter, or I 0 Ti H E R T [ Pp S I 
will connect to your social media accounts. Regularly I 1 
check what does and does not have access to your I BLL: WG St SME Tad fy oa ape se 
a account, as old apps may end up compromised. CREATE A REDUNDANT EMAIL ACCOUNT . 
i For accounts that aren't important or don't contain I 
BE CAREFUL WHAT YOU SHARE | important information, use a second email account to sign I 
It may be common sense, but always think about | upto them. That way, if someone cracks your secondary I 
what information you're giving out. email, they won't have the keys to the kingdom. 
USE A PSEUDONYM KEEP YOUR SOFTWARE UPDATED 
While perhaps an extreme step and not applicable | Acommon part of software updates include security fixes, I 
on every social media network, it will aid your | soalways update your software when you can. I 
privacy and security. 
I BE AWARE OF PHISHING SCAMS , 
j Always remember that hackers will send emails that look l 
| like they're from your bank or Facebook or similar asking I 
I you to log in. Check the sender and if in doubt, go to the I 
original website. . 
. 5,000 PAGES \\ 
-- \, ] ADD RECOVERY CONTACT INFO I 
! Google recommends you add a phone number or alternate =I 
! email to an important account so they can contact you if I 
: they think anything is wrong and confirm it is the real you. 
I I 
— ee ee 
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Keep your Raspberry Pi, and any files on it, safe and secure 


he Raspberry Pi is inherently fairly secure, I 

T especially if you’re using the default I 

operating system, Raspbian with Raspberry 

Pi Desktop. Raspbian is a form of Linux, which is I 
much more resistant to hacking than Windows or I PA S SWO RD 

macOS, and you’re also unlikely to come across any I 

viruses for it. I 

While secure, it doesn’t meant Raspberry Pi and 

I 

I 


Raspbian are invincible. Here are some tweaks you 
can do to make sure your Raspberry Pi and everything 


on it are more secure. os a = = al 
¢ \ 
4 
! ‘ 


As the pi username is the default, you may wish to 

create a new user account and remove the ‘pi’ user 
from being able to make changes to Raspbian. Find 
out how to do this here: 
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SSH (Secure Shell) is a way for computers to talk to 
each other over a network. It’s like being able to open 
a Terminal window on another computer - although 
you have to know where the computer you want to talk 
to is, and the username and password. 

On Raspbian this is made easy - by default all 
Raspbian-powered Pis use ‘raspberrypi’ as their name 
on a network. To SSH in, all you need to do is navigate 
to pi@raspberrypi and enter the password raspberry. 
SSH is turned off by default; however, if you do decide 
to turn it on, look at the above tip on how to change 
the password. 


From the Raspberry Menu, go to Preferences and find 
the Raspberry Pi Configuration option. From there, go 
to the Interfaces tab and click Enable next to SSH. 


ENCRYPTION 


Encrypt your Raspberry Pi’s storage 
so that only you can access it 


Once you've set up Raspbian on your Raspberry Pi, you 
can encrypt the root partition (where the operating 
system is kept) to make sure that you need a password to 
access any of the files within. 

You might be wondering why you would need to do this 
over just turning off automatic login - the reason is that 
the microSD card can be removed from the Raspberry Pi 
and the files read on another computer. If you encrypt the 


KALI LINUK 


If you need an all-in-one encrypted operating system 
with maximum security, try out Kali Linux. It's already 
extremely secure, and with a few modifications it can 
be fully encrypted as well! 

Kali Linux is not your average Pi operating system, 
though - it’s for computing professionals who need to 
test their networks for vulnerabilities. You won't be able to 
make the same kind of projects as you would in Raspbian. 
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You can find out more on how SSH works in 


Raspbian in the documentation, including how 
to turn it on when you don’t have a monitor, 
here: 


ones 
7? »s 
¢ x 
f A 
| Check out \ 
i the full Raspberry Pi l 


\_list of ways to improve | 
\ Raspbian's security: a 


\ 4 


x 0? 
- 
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SECURE YOUR 
COMPUTERS 
WITH PI-HOLE 


i Pe 


INSTALL 
PI-HOLE 


You’ll need: 
Raspberry Pi (any model) 
Raspbian, connected to a network 


Pi-hole turns your Raspberry Pi into an 
ad-blocker, making sure no malicious 
code from dodgy adverts gets to your PC 


nline ads can be dangerous for your 

computer and your network. Malicious 

code can easily infiltrate ad networks 
and become a serious issue before the ads are 
eventually removed. While this kind of code is 
unlikely to affect your Raspberry Pi, it can infect 
other computers on your network. With some 
special software, you can create a network-wide 
ad block using just your Raspberry Pi, thanks 
to Pi-hole. 


>STEP-0O1 

Get the software 

Pi-hole comes in a complete and easy-to-use installer 
that can be quickly used on your Raspberry Pi. Opena 
Terminal and use the command: 


curl -sSL https://install.pi-hole.net | bash 


ao™= m= This will download and then automatically install 
0 \ the Pi-hole software. You can do this in the command 
y WANT TO line (we recommend you turn off the desktop for your 
WHITELIST WEBSITES Pi-hole device anyway) as well as SSH. 
YOU KNOW TO BE SAFE? 
Check out the I >STEP-02 


Configure your network 

For the desired ad-blocking effect, you need to make 
it so all the computers on your network access the 
internet via your Pi-hole Raspberry Pi. To do this, 
you need to change the DNS settings on your router. 
This requires you to know your Pi’s IP address on the 
network, so run the command ifconfig to find it. 


\ details on how here: | 
\) omagpi.cc/2Bz8n64 6 
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o 
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Your router will have instructions on how to access 
the admin settings, usually printed on a label on 
the back of the box. Log in to your router and find 
the settings for its DHCP server. This is used to 
automatically send details to your devices on how to 
connect to the internet. Change the value of the static 
IP address to that of your Raspberry Pi on the network. 
It might require a restart afterwards, but otherwise 
you’re done! 


Configure your network 
If you can’t change the DHCP settings on your router, 
you can turn on Pi-hole’s own DHCP server which will 
then automatically manage devices on your network. 
You can find this option, along with many other 
settings, by going to pi-hole in a web browser. 

There are other more advanced/manual methods 
for sorting out the DNS settings as well, and they 
can all be found in the Pi-hole documentation here: 
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SECURE YO 
NETWORK 
WITH TOR 


Create an automatic Tor router that 
anonymises your online location, 
allowing you to maintain complete privacy 


eg ee ee ee eee ee eee eed 


rivacy on the internet is tricky. Everywhere 

you go you accumulate cookies and servers 

will log your IP. For vulnerable people, this 
can be dangerous. Tor allows you to almost completely 
mask your presence online, 
and here’s how you can use 
a Raspberry Pi to make your 
entire network private. 


You’ ll need: 
Raspberry Pi 3 
Ethernet cable 


First of all you need to turn your Raspberry Pi into 
an Access Point, which lets other computers wirelessly 
connect to it and use it as a bridge to your router. 
Connect your Pi to your router via the Ethernet cable, 
and leave the wireless LAN connection alone. To 
make the wireless LAN on the Pi3 act like an AP, just 
execute the following commands in the Terminal: 


git clone https://github.com/unixabg/ 
RPI-Wireless-Hotspot.git 

cd RPI-Wireless-Hotspot 

sudo ./install 


You’ll need to agree to some terms and DNS 
options, but say no for the wireless LAN defaults. It 
will then prompt you to enter details for the wireless 
network you want to create and connect to. For the 
final two options, choose no and your Raspberry Pi 
will reboot. 

Now we can install Tor on your Pi. First, update 
Raspbian with sudo apt-get update and then sudo 
apt-get upgrade to make sure everything is properly 
installed from the previous step, and then install 
Tor with: 


sudo apt-get install tor 
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need to configure it. 


AutomapHostsOn 
TransPort 9040 
TransListenAddress 1 
DNSPort 53 

DNSListenAddress 192.168. 


Next, you need to dump all the old ru 
the IP table: 


sudo iptables -F 
sudo iptables -t nat -F 


Now set the DNS to route through Tor: 


sudo iptables -t nat -A PREROUTING -i wland@ 
-p udp --dport 53 -j REDIRECT --to-ports 53 


Route all TCP traffic through Tor: 


sudo iptables -t nat -A PREROUTING -i wlan®@ 
-p tcp --syn -j REDIRECT --to-ports 9040 


Make sure to check all these new routes with: 
sudo iptables -t nat -L 
Finally, save our new rules to the NAT table: 


sudo sh -c "iptables-save > /etc/iptables. 
ipv4.nat" 


Once that’s down, you should create a log file to 
track your Pi’s Tor usage. Create an empty file and 
then change its permissions with: 


sudo touch /var/log/tor/notices.log 
sudo chown debian-tor /var/log/tor/notices. log 
sudo chmod 644 /var/log/tor/notices.log 


Once that’s all done, you can start the Tor service 
with sudo service tor start. You can also then 
check it with sudo service tor status to make 
sure it’s all running properly. 

Finally, change the service to start on boot with: 


sudo update-rc.d tor enable 
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HOW 
WORKS 


Relay networking and how 
it keeps you safe online 


or’s main function is to protect your 
T anonymity online. The way it does this is by 
routing web traffic through several encrypted 
servers around the world — ina sense, it bounces the 
contents of a webpage around different computers 
across the globe to then be read by your computer. 
A bit like in a film. 

This allows users to conceal their location, and 
will stop anyone monitoring your network from 
figuring out what you’re using the internet for. This 
can be anything as simple as concealing what you’re 
getting a network engineer for their birthday, or for 
more serious uses such as staying hidden from an 
abusive partner. 

Tor is not invincible though, and should be used 
with caution. Not every website allows access via Tor 
either. If you don’t want to have your entire network 
running under Tor, you can always use the Tor 
Browser: 


Congratulations! 
s brows figured t 


2, 


Whoet Next? 


You Can Help! 


@éeaus ow Poe jee 


The Tor Browser is an alternate way of staying hidden 
on the internet instead of encrypting your entire network 
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Want to learn more about Raspberry Pi and 
computing security? Check out these links. 


A general advice website that gives privacy tips 
on just about every part of your online experience 
— it even has sections on how parents can help 
safeguard their kids. Privacy and security online is 
always evolving, so it’s worth checking regularly 
to see how you can improve your online safety. 


On eters te her et Ory 


Official advice from Raspberry Pi on ways you 
can improve the security on Raspbian and your 
Raspberry Pi. It covers some of the stuff we 
mentioned on previous pages but goes into a lot 
more detail, as well as offering more advanced 
methods of controlling your security on the Pi. 


Change your default password 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 3 


Amazing hacking and making projects 
from the makers of MdgPi magazine 
Inside: 

@ How to get started coding on Raspberry Pi 
@® The most inspirational community projects 
® Essential tutorials, guides, and ideas 


@® Expert reviews and buying advice 


7 Available : : 
GP acpi.cc/Magpistore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
@ App Store > Google Play 
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HOLOGRAM NOVA 


Maker 
says 
Nova is 
the simplest 
plug-and- 
play modem 
for instant 


connectivity 
Hologram 


Connecting a Raspberry Pi to a mobile 
network anywhere in the world is something 
Rob Zwetsloot is very interested in 


n past issues we’ve talked one of the first made specifically strength of the signal where you’re 
about ‘mobile’ Raspberry with Raspberry Pis in mind, and it planning to use it. 
Pi devices a few times in works really well. 
various contexts. However, one The Nova itself is a very simple Software & subscriptions 
of the concerns with creating a device. It’s a USB dongle that you The Nova isn’t just plug-and- 
truly mobile Raspberry Pi project can slot a SIM card into (supplied play, though — you won’t be able 
is giving your Pi an internet with the Nova) and then plug to just use it like a WiFi dongle on 
connection wherever you go. into your Raspberry Pi. You can a Raspberry Pi. Luckily, you only 
LEARN MORE You could always hack about with disassemble it to access the SIM need to install one bit of software 
ABOUTNOVA =a mobile hotspot on your phone, card slot and swap between two which is available online (Hologram 
a lcaie but cellular modems have always included antennas depending on recommends you have a pre- 
how to set up been an alternative. The Nova is how much space you have and the existing network connection to set 
and use your up your Nova before using it) to get 
eee ® Zone) © Zone 2 lincludes Zone 1 coverage yourself connected, with another 
The MagPi. piece of software required to use the 
a= SMS features. 


While getting your Raspberry 
Pi to connect to a mobile network 
through the Nova is easy and quick, 
it doesn’t mean you’ ll then have 
instant internet access. For that, 
you need to set up a subscription to 
Hologram’s data plan. 

It’s easy enough to activate your 
SIM card on there. You just create 
an account, put in your SIM card’s 


magpi.cc/2AqrV6q 
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serial number, and select froma 
few data plan options. By default, 
you can select from a couple of 
pay-as-you-go options that charge 
you by the megabyte (and SMS), 
with differences in price depending 
on what countries you’d like the 
Nova to work in. 


size and quality of photos taken by 
the Raspberry Pi Camera Module 
to keep the file size (and therefore 
upload price) fairly fixed and 
within a project’s budget. 

You can upgrade the plan from 
‘most of the world’ (Zone 1) to 
‘almost all of the world’ (Zone 2), 


The Nova is one of the first made 
specifically with Raspberry Pis 
in mind, and it works really well 


There’s also a monthly contract 
plan, but it’s currently only 
available to people in the US. 


Pricing and regions 

The cost of Nova is fairly cheap 

at $0.60 (£0.43) per minute for 
most of the world, along with 
$0.19 (£0.14) for each SMS. While 
it would be pretty expensive to 
use it to stream YouTube videos 
on the go, that’s not really what 
it’s meant for — it’s more for 
quick data uploads and location 
pings for more advanced projects. 
Even for photos it’s not too bad, 
especially as you can tweak the 
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which notably includes Canada 
among other countries. The price 
bump is about 33%, going from 
$0.60 to $0.80 (£0.58) per megabyte 
and up to So.30 (£0.22) for a text. 
It’s not huge but depending on the 
amount of data you’re planning to 
use, it can be a significant jump. It 
also mostly affects less developed 
countries, although it’s unlikely this 
would be their first port of call for 
internet access. 

With the contract, you can save 
a lot of money on Zone 1 data 
(100MB for $15/£11) and some 
money on Zone 2 (100MB for 
$60/£43), although the price of 


HOLOGRAM NOVA 


SMS texts remain the same. Again, 
you need to be in the US to get the 
contract, but it’s well worth it for 
the Zone 1 savings. 


Usage and connection 
While we weren’t able to test it 
in every country, in the UK and 
the US we’ve found that the 
Nova works great. Focusing on 
sending small packets or limited 
file sizes of data is the way to go, 
although you’re sometimes at the 
mercy of the mobile signal so we 
recommend making sure you check 
signal strength before deploying. 
It’s frankly a wonderful little 
product, and although it may 
be aimed more at a developer/ 
business market, it ticks the right 
boxes for those specific uses. 


{ast word 


The Nova is a great addition 
to the line-up of Raspberry 
Pi accessories that can really 


help improve some of your 
mobile projects. 
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Score:Zero 
is Gd Super 
simple 
soldering 
project 

for your 


Raspberry Pi! 


The Wonky 
Resistor Co. 


JOY 
BONNET 


Amore 
expensive 
product, the Joy 
Bonnet features 
a mini joystick 
and six buttons. 
It comes fully 
assembled so 
no soldering 

is required. 


£16 / $15 
magpi.cc/2qaSfiT 
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Super-SimpPie | 
SoiderinG With 
Siuie! 
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SCORE!ZERO 


A tiny controller that also helps you practise your soldering 


ver since the Pi Zero came 

out, its use for video game 

console projects has been 
widely explored. From installing 
them into classic controllers to 
hacking Happy Meal toys into 
working Game Boys, it’s been 
great to see just how inventive 
people have become with them. 
Sometimes though, you need 
something a little more practical, 
like the Score:Zero. 

It’s a plain, white PCB the size 
of a Pi Zero that comes witha 
40-pin GPIO header and buttons. 
You solder these on and then 
place it on a Raspberry Pi’s GPIO 
pins — anice and simple concept. 
As there’s not much to solder, it is 
fairly quick to do and is a good way 


) to practise soldering a 40-pin GPIO 


header — in this case a female one. 
We did find some of the buttons a 
little small and fiddly, though, so 

make sure you’re at a clear work 
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area when opening the box and 
getting everything ready, lest you 
lose a button. 


Small hands 

Once you’ve soldered it up, you 
need to install some software to 
get the Score:Zero working on your 
Raspberry Pi. The Wonky Resistor 
website has a great little guide 

to help you do the soldering and 
installing — in fact, just one line 

of code will get you some example 
code to use with it. 

The code is all done with GPIO 
Zero so you can easily put it into 
your own game projects without 
having to download any of the 
code. However, you can use 
the examples along with some 
other software to quickly use the 
Score:Zero as a keyboard or mouse. 

With it sitting on top of a Pi 
Zero, we found the Score:Zero a bit 
awkward to use. The diminutive 


size of both hampered proper 
usage and the microswitches 

for the D-pad weren’t very 
comfortable to use. On a full-size 
Raspberry Pi, though, the story was 
very different — we thought we’d 
have trouble reaching the buttons 
at all, but it was generally a lot 
more comfortable to use. For those 
with smaller hands who might get 
the most out of learning to solder 
and code with it, the Pi Zero size 
probably won’t be too much of an 
issue, though. 


{ast word 


Anice quick project that, while 
a bit small for adults, will be 
perfect for younger makers 


getting their start in soldering 
and programming. 
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Raspberry Pi finds a new home 


Versatile enclosure for Raspberry Pi B+ 


The new UCS-RPI Universal Case System for Raspberry Pi B+ has pre-milled side 
walls for easy access to the I/O and power inputs. It is available in black or grey, in 
two size configurations and with glue dot location posts to secure the single board 


computer to the case. 


For additional information call 0845 881 2222 or visit 


phoenixcontact.co.uk/RPIBC 
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INSPIRING INNOVATIONS 


FULL PHAT 


Maker 
says 
Connect 
two pHATs 
to your Pi 
and still 
use spare 


GPIO ports 
RasPiO 
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PHAT 
STACK 
Need to 
connect more 
add-on boards 
to your Pi? The 
pHAT Stack 
lets you use up 
to five pHATs, 
three HATs, or 
a combination. 


£14 / $16 
magpi.cc/2mcr2Gt 


FULL PHA! 


Have double the fun by plugging in two pHATs at once. By Phil King 


ou may recall that we 
reviewed Pimoroni’s pHAT 
Stack last issue. The latter 
is amonster of a breakout board 
that enables the connection of 
up to five pHAT boards - or three 
HATs — to one Raspberry Pi. 
While it works very well, we did 
mention that it might seem like 
overkill to some people. In which 
case the Full pHAT might well 
prove a more practical alternative 
with its smaller form factor. Fitting 
neatly on top of the Raspberry Pi, it 
allows you to connect two pHATs, 
or a pHAT anda HAT. 
Well, it does once assembled. 
You first need to solder on a female 
stackable 40-pin header, anda 


~ male header. Two nylon standoffs 


are also supplied to provide a 
secure fit on top of the Raspberry 
Pi. For a low-profile project, you 
could even solder the Full pHAT 
directly to a Pi Zero and eliminate 
the main header altogether. 
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The GPIO ports (all bar GPIO 26) 
are broken out twice more in two 
single rows of holes, labelled with 
special functions (e.g. SDA, SCL, Tx, 
Rx) where applicable. In addition, 
there are three holes for 5V, 3V3, 
and GND. So there’s plenty of scope 
for soldering wires directly, or via 
added pins, to connect various 
electronic components and sensors. 

The two main GPIO headers are 
also clearly labelled with their 
GPIO numbers, which is a nice 
touch and reminiscent of RasPiO’s 
Portsplus key-ring. 


Spare ports 
Once assembled and mounted on 
the Raspberry Pi, we found it easy 
to swap pHATs and HATs in and 
out — such as a Micro Dot pHAT and 
Unicorn HAT HD to simultaneously 
show scrolling text messages and 
a graphical display. 

As with the pHAT Stack, 
however, one caveat is that 


you need to avoid combining 

two add-on boards that use the 
same GPIO pins (unless they're 
PC with different addresses). 
Again, Pimoroni’s ‘pHAT 

Stack configurator’ online tool 
(magpi.cc/2BH6TSc) comes 

in handy here — assuming 

you’ re using Pimoroni boards. 
Alternatively, you can just check 
which pins they use at pinout.xyz. 


{ast word 


Fitting snugly on top of the 
Raspberry Pi, the Full pHAT 

is useful for combining two 
PHATs (or a pHAT and HAT) and 
also as a breakout board for 


projects. To this end, the clear 
labelling of all the GPIO ports is 
a great help, as is the provision 
of two extra rows of holes. 
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DIGIONE PLAYER 


Maker 
says 
Designed 
with one 
goal in mind: 
absolute 
best S/PDIF 


output 
Allo 


DIGIONE PLAYER 


Clever engineering and top-end components 


JUSTBOOM 
DIG! HAT 


It lacks the 
advanced 
features of the 
DigiOne, but the 
JustBoom Digi 
HAT provides 
an S/PDIF on 
optical and 
coaxial outputs 
for a fraction 
of the price. 


£30 /$35 
magpi.cc/2IMEYFx 
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or many, the audio on 

the Raspberry Pi’s HDMI 
port — or even the stereo 
analogue audio, accessible on the 
multifunction 3.5mm jack - is good 
enough. For others, ‘good enough’ 
is never good enough - and it’s for 
these people that the Allo DigiOne 
Player has been designed. 

Based around the DigiOne 
S/PDIF HAT (available separately, 
£86/S99), the DigiOne Player is 
designed to provide a peak-quality 
digital audio signal. While many 
will argue that digital audio is 
digital audio, being made up of 
zeros and ones which either arrive 
at the other end perfectly or don’t 
arrive at all, audiophiles claim 
otherwise — and in particular, point 
to ‘jitter,’ the deviation of a period 
signal from its ideal timings, as a 
source of audible distortion. 

The DigiOne, Allo claims, 
solves that problem. Using two 
on-board clocks as stable timing 
sources, as well as galvanic signal 
and power isolation and a variety 
of other engineering tricks, 


Allo claims to have reduced the 
jitter of the digital audio signal 
to 0.6 picoseconds — as close to 
perfect as practically possible. 
That signal is available on 
either of the DigiOne’s two outputs: 
an RCA jack and a BNC connector. 
In practice, there’s no difference 
between the two, bar the BNC 
connector being more resistant to 
accidental disconnection. What you 
won’t find is an optical output, a 
deliberate design choice by Allo to 
avoid what it claims is unacceptable 
4 nanosecond (4000 picosecond) 
built-in jitter. 


Complete bundle 
Purchased as the Player bundle, 
the DigiOne HAT comes with a 
Raspberry Pi 3; 8GB SD card with 
a choice of DietPi, Volumio, or 
Max2Play audiophile-centric 
distributions pre-installed; a5V 
3A power supply; and an attractive 
acrylic case. 

Using the DigiOne Player is as 
simple as connecting a power 
supply and linking the HAT to your 


digital-to-analogue converter 
(DAC), with the tested Volumio 
software providing a browser- 
based interface for control as 
well as acting as a streaming 
transport device for third-party 
software. When running, the audio 
quality from the DigiOne Player is 
undeniably high — but it is more 
obvious to scientific instruments 
than the fallible human ear. 


{ast word 


The DigiOne Player is a clever 
piece of engineering, but the 


problem it solves is arguably 
not worth the purchase price. 
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Build a Makerspace 
for Young People 


Join our free online training course on 
makerspace design to get expert advice — 
for setting up a makerspace in your 

school or community. == 


@ raspberry Pi The Raspberry Pi Foundation. UK registered charity 1129409 #RPiLearn 


PIGLOW 


Aspiral nebula 
of 18 individually 
controllable 
LEDs supported 
with a Python 
library. Can be 
used for status 
output or purely 
for decorative 
patterns. 


£9/$12 


magpi.cc/2nxGOvl 
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PICUBE 


Maker 
says 
Strengthen 
your logic by 
typing complex 
code to draw 


patterns 
SB Components 


P|CUBE 


Add a tower of 64 LEDs to the top of your Pi 


and create hypnotic sequences. By Sean McManus 


iCube is a 4x4%4 grid of 
LEDs to sit on top of your 
Raspberry Pi 2, 3, or Zero. 
That means there’s a total of 64 
lights, many more than you could 
connect directly to the GPIO pins. 

The secret is multiplexing: the 
pins are arranged in columns and 
layers. All the LEDs in the same 
column share a common anode, 
and all the LEDs in the same layer 
share acommon cathode. That 
means each horizontal layer has 
the same lights switched on as the 
others, or is completely dark. As 
a result, PiCube isn’t suitable for 
games or projects that would need 
the lights to be independently 
controllable. It’s fun to experiment 
with, though, and could provide 
a highly visual way of teaching 
nested loops and nested lists, 
or experimenting with logic. 

You don’t need to install any 
software because you can control 
the PiCube using the RPi.GPIO 
Python package to turn pins on 


or off. The documentation shows 
which pins control which layers 
or columns, and the LEDs are 
numbered on the board to help 
you find your way around. 


Cubist light 

There are three mesmerising 
demos to download, showing 
different animations you can 
create. IDLE complained about 
inconsistent indentation in the 
first one, and wouldn’t run it. 

The demos are unexpectedly in 
Python 2 (rather than 3) because 
of some old-style print statements, 
too. This all took seconds to fix, 
but it was disappointing that it 
didn’t work immediately. A simple 
‘Hello world!’ demo explaining 
how the layers work would have 
been helpful too. 

PiCube comes flat-packed, ready 
for you to build. There are 64 LEDs 
to solder, as well as soldering the 
layers to the pillars, the pillars 
to the shield, and the shield to 


the header. We make that 144 
joints, pins, or lights. That makes 
this a good project for those who 
are looking for a substantial 
soldering project with a bit more 
programmability than the usual 
LED displays. 

We experienced a dead LED on 
two of the three units we tested. 
Our units arrived pre-soldered 
(thank you!), so we don’t know 
how many knocks they took in 
transit, and this might not be 
typical. You can test LEDs before 
soldering them to avoid problems, 
as the manual recommends. 


fast word 


Anice tech demo that is fun to 
experiment with and a highly 
visual teaching aid. It has 


limited applications beyond 
education, though. 
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WITTY PI MINI 


Maker 
says 
Define 
complex 
on/off 
sequences 
with a 


simple script 
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WITTY Pi MIN 


Want to save power, or run a program intermittently? Witty Pi Mini 
turns your Pi on and off automatically. By Sean McManus 


WITTY PI 2 
Its ‘big sister 
Witty Pi 2 keeps 
time for up to 

a year without 
external power. 
It can output 3A 
current to power 
peripherals too. 


£17 / $24 
magpi.cc/2nxB7gU 


itty Pi Mini adds a 

real-time clock to your 

Raspberry Pi so you can 
switch it on or off automatically, 
at set times. 

To set it up, you can create a 
simple configuration file using a 
text editor. You specify the start 
and end time for the sequence, and 
then say how long the Pi should be 
switched on for, and then switched 
off for. The on/off cycle loops 
until the end time is reached. If 
you prefer, there’s a nice online 
generator you can use to create the 
code, which includes a simulator 
showing you when your Pi would 
switch on and off using it. 

To install your configuration file, 
you use a Bash script which can 
also show you the next scheduled 
shutdown and startup times, or 
reset the Witty Pi Mini. A selection 
of example scripts is provided, 
such as ‘turn on for five minutes 
every 20 minutes’. 
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You can also use wildcards to set 
the shutdown or startup times, 
so that your Pi turns on at quarter 
past every hour, for example. 


Power up 
There’s a graphical interface 
version of the Bash script, which 
might provide some comfort to 
those who prefer not to use the 
command line. It was extremely 
slow on our Pi Zero WH, though, 
with a significant delay after 
clicking a button. It takes several 
seconds to commit a time change, 
so setting the clock with second- 
accuracy was hard. It also appeared 
to lag a few seconds behind the 
time shown in the command line. 
There are a few usability niggles 
too, so we found we preferred the 
Bash script with its simple menu. 
The real-time clock is powered 
using a capacitor, so the clock 
runs for about 17 hours without 
an external power supply. 


The Witty Pi Mini uses four GPIO 
pins, two of which are customisable 
(with some soldering). You might 
be able to combine it with other 
HATs, and should be able to use it 
with your own electronics projects. 
A stacking header is available 
separately to enable you to access 
all of the GPIO pins. 

When the Pi shuts down on 
schedule, it’s merciless: whatever 
you’ re doing, it’s going down. 
Make sure you remember if you set 
a shutdown schedule so you don’t 
get any unpleasant surprises. 


{ast word 


Witty Pi Mini is a great tool 
if you need your Pi to do 
something on a schedule. The 


Bash script, online generator, 
and manual will get you and 
your Pi running like clockwork. 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 


THE (NEW) MAGAZINE 
mae MODERN MAKER 


ISSUE #04 


OUT NOW 


hsmag.cc 


GET IT ON 
>> Google Play 
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BOOKS 


RASPBERRY PI 
BESTSELLERS 


Introductions to extending interesting 
languages make for some of our favourites 
in Pragmatic’s excellent Express series. 


MASTERING RUBY 
CLOSURES 


Author: Benjamin Tan Wei Hao 

Publisher: OReilly Coare 
Price: £21.50 ag = 
ISBN: 978-1680502619 
magpi.cc/2GEg91¢z 


_. 
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An easy introduction to 
Ruby's secret weapon. The __ 
difficulty ramps up steadily, but 

examples and tests keep you 

on track, giving you closure 

understanding that you can 

take on to Haskell, JavaScript, 

or Elixir. 


MASTERING CLOJURE 
MACROS 


Author: Colin Jones 
Publisher: OReilly 
Price: £13.50 

ISBN: 978-1941222225 
magpi.cc/2GCWzda 


Clojure’s powerful macro 
system makes “hard things 
possible and normal things 
easy”. Jones's easy style 

makes for a painless intro, with 
intriguing suggestions for when 
to use them, but also how to 
use new your powers wisely. 


METAPROGRAMMING ELIXIR 


Author: Chris McCord — | 


Publisher: OReilly 
Price: £13.50 

ISBN: 978-1680500417 
magpi.cc/2GCX6Mc 


Not for the Elixir beginner, 

but a terrific introduction to 
accessing Elixirs Abstract 
Syntax Tree, and understanding 
metaprogramming through % | 

Elixir's surprisingly Lisp-like ont . * [ae 
features. Useful examples a 

include an internationalisation 
library, and an HTML chapter. 
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MASTERING 


MEDIA wis te 
RASPBERRY PI 


Author: Ralph Roberts 
Publisher: Apress 
Price: £23.99 

ISBN: 978-1484227275 
magpi.cc/2GAKncO 


Despite all of its 
wonderful educational 
uses, it’s as a media centre that 
many Raspberry Pis are destined 
to spend their days. And why not? 
It’s more satisfying — and cheaper 
— than buying one off the shelf. 
Roberts provides a comprehensive 
guide to setting one up — yes, all of 
the information can be gathered 
from the web, but delegating that 
effort to Ralph Roberts will make 
your life easier. 

There are several things to 
consider to get the correct setup 


ATTACKING 
NETWORK 
PROTOCOLS 


Attacking 


Author: James Forshaw 
Publisher: No Starch 
Price: £39.99 

ISBN: 978-1593277505 
magpi.cc/2GyErRL 
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Forshaw is quite 
well known for 
finding a number 
of Microsoft security flaws, earning 
the first $100 000 bounty from 
Microsoft for using architectural- 
level flaws to bypass platform 
defences. Here he turns his 
attention to the kinds of network 
weaknesses which a proliferation 
of IoT devices will bring to 

homes everywhere. 

Networking basics and capturing 
traffic with Wireshark open the 
book. The reader’s hand is not held, 
as we gallop through the basics, 
and on to the binary protocol 


Network Protocals 


even at the hardware level. From 
careful consideration of getting the 
correct power supply - something 
which has occasionally tripped up 
new (and not so new) Pi users — 
and powering peripherals, to 
CEC over HDMI. The book is 
standardised on one digital-to- 
analogue converter (DAC), and 
doesn’t examine closely any of 
the other DACs available. There 
are other quirks, too, but the 
choices made are all practical. 
This is mostly a guide to Kodi, 
on LibreELEC — a sensible choice, 
and one with plenty of expansion 
options. These add-ons are also 
covered, and the guide is pitched 
such that you could give it to 
a fairly non-technical relative 
and be reasonably hopeful that 
they’d need no additional help! 
A useful resource. 


Score 


structures that underlie network 

traffic, then practical approaches 

to more difficult traffic capture, 

and a more detailed look at packet 

analysis, and some achievable 
reverse engineering. 

Now you’ re ready to find 
(and even exploit) some 
vulnerabilities, with practical 
chapters using .NET Core. The 

chapter on network protocol 
security should give you a fresh 
appreciation of cryptography, 
and re-implementing them (in 
Java or C this time) may leave 
you nervous of trusting anything 
that you receive — time to dive into 
the root causes of vulnerabilities 
and gain a much better 
understanding not just of these but, 
thanks to Forshaw’s examples, a 
better practical understanding of 
many aspects of code execution. 
Challenging in many ways, and 
rewarding in equal measure. 


Score 
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ELEGANT SCIPY 


Authors: Juan Nunez-lglesias, 
Stéfan van der Walt 

& Harriet Dashnow 

Publisher: O'Reilly 

Price: £31.99 

ISBN: 978-1491922873 
magpi.cc/2GCaijjp 


SciPy, NumPy, 
Pandas, and scikit-image 

give not just the data scientist, 
but biologists and other users 

of image and signal processing, 
almost everything they need to 
do great work. Something that we 
may have mentioned in previous 
reviews here. This book is not 
just about the tools and how to 
use them — but how to use them 
with code that is clear, concise, 
and efficient. 

Along the way, this enjoyable 
and occasionally entertaining 
guide revels in the joy of elegant 
code, whilst demonstrating 
quite practical examples across 
a range of sciences — starting 


DOCKER FOR 
DATA SCIENCE 


Author: Joshua Cook 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484230114 
magpi.cc/2GDzcjs 


A book straddling 
many fields — 
aiming to teach 
Docker and its ecosystem, but 
using the field of data science 
throughout. Jupyter Notebook 
Server is the tool of choice, and 
a Jupyter/SciPy image on AWS. 
Docker and Jupyter are then 
brought together — first with an 
example program in C. 

That done, we jump forward 
30 years to [Python and NumPy, 
and spend the rest of the book 
more comfortably programming 
interactively in Python. Jupyter 
and Docker alternate as the 
main focus, meaning you get 


raspberrypi.org/magpi 


~L 
le er Weak hase 


with NumPy’s N-dimensional 
arrays with genome data, then 
sticking with the gene 
expression data, and 
moving on to quantile 
normalisation, then 
images as NumPy arrays. 
Fast Fourier Transform 
with SciPy takes in 
birdsong, moon landing 
pictures, and radar data; 
the three authors ensure 
a diversity of examples, yet write 
with a unity of purpose and even 
humour. Chapters on sparse 
matrix problems and linear 
algebra present several exercises 
for you to stretch the SciPy skills 
you’ve gained so far, and the 
chance to consider PageRank’s 
usefulness in examining 
ecosystems. The Toolz streaming 
library for large data sets 
rounds off a genuinely essential 
introduction to SciPy. 


Score 


just enough of each, rather than 

the in-depth look at SciPy in the 

O’Reilly book reviewed above. If 
you need both depth and 
breadth, start with this 

one. Following on from data 

persistence with PostgreSQL, 

the chapter on Docker 

Compose (for multi-container 
applications) brings in 
examples with Redis, and with 
MongoDB, as well as scaling to 
larger AWS instances. 

Cook is an experienced teacher, 
with multiple interests and a clear 
style - all of which enables him to 
pull off the tricky juggling act of 
helping you to overcome Python- 
based data science challenges in 
the ‘infrastructure as code’ world 
without this once seeming to bea 
book designed to squeeze as many 
hot topics in as possible. Quite 
an achievement! 


Score 


OOKS 


ESSENTIAL READING: 


GO LEARNING 


Not yet a decade old, Google's concurrency- 
friendly, typed language is not one you can ignore. 


Go In Action 


Authors: William Kennedy, 
Brian Ketelsen & Erik St. Martin 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1617291784 
magpi.cc/2GEBboo 


Gives you the why as well as the how, 
for real understanding in addition to 
practical knowledge - and is very 
good on concurrency. 


Go In Practice 


Authors: Matt Butcher & Matt Farina 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1633430075 
magpi.cc/2vjoJBA 


Excellent cookbook-style collection of Go 
recipes that will enlighten you on Go, as 
well as solving your practical problems. 


The Little Go Book 


Author: Karl Seguin 
Publisher: OpenMyMind.net 
Price: Free download 
magpi.cc/2GyAbBE 


Ashort, CC-licensed introduction; if 
you're a developer looking for a quick 
start, this will get you up and running. 


Go Web Programming 


Author: Sau Sheong Chang 
Publisher: Manning 

Price: £27.99 

ISBN: 978-1617292569 
magpi.cc/2foFFg9a 


You may be surprised to hear that Go is 
good for writing web apps; after reading 
this book you'll be convinced. 


The Go Programming 
Language ie 
Author: Alan A. A. Donovan 
& Brian Kernighan 
Publisher: Addison-Wesley 
Price: £29.99 

ISBN: 978-0134190440 
gopLio 


Not quite a K&R for Go, but this is an - —— 
essential and practical guide to really 
learning the language in depth. 
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FOLLOW MISSIONS 
LEARN PROGRAMMING 


Special $10 MagPi coupon: 


only at BuildPiper.com 


‘It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ° 
| gf | 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


a A 


SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
; Stanford-StartX Fund 
Cad AEF of Princeton University 


Available at: 
BuildPiper.com amazon ys$iu BARNES<NOBLE 


INTERVIEW 


Community 
MARINE SCIENCE WITH 


RASPBERRY PI 


Monitoring mussels and how 
humans affect their environment 
turned out to be a job for the 
Raspberry Pi 


Occupation: Environmental Engineer 


e like seeing the Raspberry 
@ Pi used for science, so 
when Jonathan approached 
us about how he’d been using 
Pi Zeros to study mussels for 
his masters thesis, we were 
immediately intrigued. Jonathan 
is a great lover of nature, and is an 
avid nature photographer as well 
as environmental scientist. 


Can you tell us about your 
masters project? 

Last summer I wrote my master 
thesis with the goal to create a 
battery-powered biological sensor 
system (a biosensor) that can 
monitor water quality. For this 
project I connected blue mussels 
(Mytilus edulis) to a Raspberry Pi 
Zero to monitor their movement. 
The project was very successful. 
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Why use the Raspberry Pi? 

Since the Zero is cheap, uses 
little energy, and can easily be 
programmed with Python, it was 
the perfect match for this project. 


What have you used the Raspberry 
Pi for in the past? 

I have used the Raspberry Pi 

to control wireless cameras 

for monitoring purposes in 
hazardous environments. I have 
also used Raspberry Pi boards to 
control viewing screens at the 

local university. 


What kind of results did you get? 
The experiments showed that blue 
mussels’ behaviour (valve gape 
movement) is altered by physical 
stimuli such as light, temperature, 
and access to food. The blue 


mussels are most active during 
night-time when it is less light. 
The biosensor system based on the 
Raspberry Pi proved very robust 
and reliable for this project. 


Would you use a Raspberry Pi 
setup again? 

Iam planning to use the Raspberry 
Pi in a lot of future projects! 


Above The cage that the mussels were 
kept in was submerged in water so they 
could be studied in their natural habitat 


raspberrypi.org/magpi 


aspberry Jams are great, but 

what if you can’t attend one? 

York PiJam has found a way 
around that by offering an online 
Raspberry Jam (virtual.yorkpi.tech) 
that gives out tasks to its members. 
They have to complete a project ina 
week — like ina traditional game jam 
— and while prizes are given out, fun 
is the name of the game. 


Can you tell us about the 

Virtual Jam? 

A Virtual Pi Jam is an opportunity 
for people who have no knowledge 
in coding to have a go. We supply 
them with tutorials for Scratch, 
Python, HTML, etc. They have a 
weekend or a whole week to create 

a project and then submit it. The 
submissions then get judged and 
the winners get prizes. These 

prizes come from companies such 
as ModMyPi who have helped 
massively with the Virtual Pi Jams. 
The Virtual Pi Jams also allow people 
who have no local Raspberry Pi Jams 
to join in. 
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The winner 
of the joke-themed 


Jam created an 
entire website 
filled with jokes 


Why did you decide to start a 
Raspberry Jam? 

There was a blog post on the 
Raspberry Pi website about starting 
new Jams and the idea intrigued 
me. Also, the fact that there wasn’t 
really a Code Club at my school and 
I wanted to get people into physical 
computing and programming and 
give them the same opportunities | 
have had. 


Why virtual? 

Again, it gives such a massive 
opportunity for schools and 
individual groups to get involved and 
have a chance to win prizes. From 
this we have seen websites, coded 
traffic lights, and games on the 
Sense HAT. Not only does it allow 
opportunities, but also a chance 
for people with no knowledge or 
local jams to get involved. We also 
do love to see projects from coders 
with knowledge. 


et 
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How many people attend the Jam? 
In our December Jam, for which we 
had the theme of ‘Lost In Space’, 
we had people submitting from five 
different countries including the 
USA, UK, and France. We also had 

a different range of groups taking 
part. Some were schools, some 
were friends. We roughly had 100 
submissions that were whittled 
down so we could give out the prizes 
of £10 ModMyPi gift cards, some 
ModMyPi goody bags including some 
Pi cases and Haribos, and alsoa 
Devslopes Life Time Access Pass. 


What sort of feedback have people 
given you about the Jam? 

People are liking the fact that it has 
no geographical restrictions and 
there is no ‘selling out’. Also, the 
fact we supply resources and by 
including prizes we are encouraging 
more people to get coding. It is great 
hearing feedback! 


Would you ever consider doing the 
Jam in real life? 

Iam actually planning a real-life 
Jam for 24 March in York. We will be 
having some small workshops and it 
should hopefully be a great day. 


What’s been your favourite 
moment holding the Jams so far? 
Getting to see the projects based on 
the monthly themes we set. Also, 
when people tweet us pictures of 
their prizes arriving by post, it is 
amazing. It is really fun. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 
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Jams that signed before the deadline last month 
also got a special kit for their event, including 
copies of The MagPi as well as an excellent T-shirt 
to commemorate the event. Make sure you get any 
free swag you can from your Jam. 
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f you’re reading this when the magazine comes 

out, it won’t be long until Raspberry Pi turns six 

years old! To celebrate, over 100 Raspberry Jams 
are taking place around the world on Saturday 3 and 
Sunday 4 March. The list of Jams is still slowly growing 
and probably will continue to do so until the Birthday 
Weekend, so if you can’t see one close to you on the list, 
keep checking to see if one is added. 

Ben Nuttall, Raspberry Pi Community Manager, has 
this to say about the Birthday Jams: 

“We're really looking forward to celebrating our 
birthday with thousands of people around the world. 
Over 48 hours, people of all ages will come together at 
more than 100 events to learn, share ideas, meet people, 
and make things during our Big Birthday Weekend. 

“Since we released the first Raspberry Pi in 2012, 
we’ve sold 17 million of them. We’re also reaching 
almost 200000 children in 130 countries around the 
world through Code Club and CoderDojo, we’ve trained 
over 1500 Raspberry Pi Certified Educators, and we’ve 
sent code written by more than 6800 children into 
space. Our magazines are read by a quarter of a million 
people, and millions more use our free online learning 
resources. There’s plenty to celebrate and even more 
still to do: we really hope you’ll join us from a Jam near 
you on 3-4 March.” 
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Big Birthday Weekend 


Ahmedabad, India 

Amsterdam, Netherlands 

Attard, Malta 

Bedfordshire, UK 

Belfast, UK 

Bletchley, UK 

Bogotd, Colombia 

Budapest, Hungary 

Cagliari, Italy 

California, USA 

California, USA 

California, USA 

Cape Town, South Africa 

Cebu, Philippines 

Chelmsford, UK 

Cheltenham, UK 

Chennai, india 

Chennai, India 

Chennai, India 

Cheshire, UK 

Chhattisgarh, India 

Chidambaram, India 

Cornwall, UK 

Cumbria, UK 

Delhi, India 

Devon, UK 

Dorset, UK 

East Sussex, UK 

East Yorkshire, UK 

Ecatepec, Mexico 

Essex, UK 

Florida, USA 

Florida, USA 

Forst, Germany 

Georgia, USA 

Glenunga, Australia 
School Raspberry Jam 

Granada, Spain 

Greenwich, UK 
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lCTETe-lemlaleleMy Surat Raspberry Pi Jam 


Hamamatsu, Japan 
Hamamatsu 2018 

Indore, India 

Isfahan, Iran 

Istanbul, Turkey 

Kanpur Nagar, India 

Kent, UK 

Kerala, India 


Kisii, Kenya 

Raspberry Jam 
Lancashire, UK 
Lancashire, UK 
Lima, Peru 
Limerick, Ireland 
London, UK 
London, UK 


Melale(elamel@e Techiribe.UK Raspberry Jam 
Birthday Party 


Manchester, UK 
Maryland, USA 

Maryland, USA 

Masvingo, Zimbabwe 
Mazandaran, Iran 

Michigan, USA 
Michigan, USA 

Montréal, Canada 

Mumbai, India 

New York, USA 


NWA e)emersy-ws Windsor Terrace / Kensington 
Raspberry Jam 

North Carolina, USA [i<eSierrere( 

\Teladialela-lameL@m Beeston Raspberry Jam 


Nottinghamshire, UK [xe s)ellieyeF inn) 
@ Worksop College 


Odisha, India 

Oklahoma, USA 

Ontario, Canada 

Ontario, Canada 
Ontario, Canada 

Oxford, UK 


4 


¢ 


Big Birthday 
7 Weekend 


3-4 
March 
2018 


3 March 


2018 


4 March 


2018 


Paris, France [iia 

Penang, Malaysia 
Pennsylvania, USA 
Pennsylvania, USA 
Perth, Australia 

Saverne, France 
Scotland, UK 
Scotland, UK 


Somerset, UK 
Weekend Jam 

Somogy. Hungary 

Sucre, Bolivia 

Tapa Teer 

Terni, Italy 

Texas, USA 

Texas, USA 

Texas, USA 

Tokyo, Japan 

Tyne and Wear, UK 

Tyne and Wear, UK 

Tyrone, UK 


Elaatem=ielief-larems Varna Raspberry Jam Big Birthday 
Weekend 2018 


Vest-Agder, Norway 
Virginia, USA 

Voi, Kenya 

wales, UK 

Wales, UK 

Wales, UK 

Washington, USA 
Washington, USA 

West Midlands, UK 
West Sussex, UK 
West Virginia, USA 
West Yorkshire, UK 
West Yorkshire, UK 
West Yorkshire, UK 
Wiltshire, UK 
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Al BETT 2018 


The annual education fair showcases 
new and upcoming teaching tech 


ince 2014, Raspberry Pi 

has been attending Bett 

— an annual educational 
technology trade show — to show 
off all the free resources and 
teacher training programmes that 
the Foundation offers. 

“Our setup this year consisted 
of four pods (imagine beefed up 
tables) in the STEAM village, and 
the mission of our highly trained 
team of education agents was 
to establish a new world record 
for highest number of teachers 
talked to in a four-day period,” 
wrote Dan Fisher, Raspberry Pi 
Foundation Project Co-ordinator, 
in a blog post. “I’m only 
half-joking.” 

You can read his full report 


on the Raspberry Pi blog 
(magpi.cc/2EC33L4), but suffice 
to say it was a great weekend for 
promoting digital making. 


The Raspberry Pi setup won Best 
Hands-On Experience, a great win 
for the hard-working Bett team 


This has been captioned 
‘educators with a mission’, 
but we prefer ‘STEAM Angels’ 


Hello World is our educational sister magazine, seen 
here with American Raspberry Pi Certified Educator 
and all-round nice bloke Nick Provenzano (left) 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


NANOSOUND DIGITAL 


A follow-up to the NanoSound DAC Pro which we 
reviewed in a previous issue, the Digital version 
provides the same excellent setup while also letting 
you connect with S/PDIF. There’s also a complete 
music-streaming box kit that will be funded with the 
new campaign, along with software updates. If you 
like using your Raspberry Pi as a music player, we 
recommend giving it a look! 


I2C METAL DETECTOR 


We’ve been around the block with the cool and 
amazing Raspberry Pi projects that people in the 
community have made, but can’t recall encountering 
any metal detectors - apart from the Discoverer robot 
featured in issue 48. This component might just help 
kickstart a movement of metal-detector projects. For 
people in the know, it uses a AD5933, a high-precision 
impedance converter which contains a Sine Wave 
DDS (direct digital synthesis) Generator from 1kHz 

to 100 kHz. Hopefully those are magic words to the 
right people. 
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VICTORIAN 
MAGIC 
DRESSER 


Magic mirrors are 
cool, but what is 
cooler is making the 
mirror section of a 


Victorian dresser into 

a magic mirror. It’s 
almost steampunky 

- perhaps adding a 
Nixie tube aesthetic 

to the display would 
make it seem truly old? 
We love it anyway. 
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EVENT CALENDAR 


DALLAS 
RASPBERRY JAM 


Want a Raspberry Jam in 
your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


JAP PI JAM 

When: Thursday 1 March 

Where: MAM College of 

Engineering and 
Technology, Trichy, India 

magpi.cc/2EyZ2qS 

A great way to find out more about 

the Pi, learn what you can do with 

it, and meet like-minded people. 


DALLAS RASPBERRY JAM 

When: Saturday 10 March 

Where: Perot Museum of Nature 
and Science, Dallas, TX, USA 

magpi.cc/2EDZB2u 

A Raspberry Jam post-birthday 

celebration. Discover amazing 

gadgets and gizmos throughout the 

museum, and learn about coding. 
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Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


OTTAWA JAM 

When: Saturday 10 March 

Where: Canada Science and 
Technology Museum, 
Ottawa, Ontario, Canada 

magpi.cc/2EAFimz 

Get your digits and neurons moving 

with hands-on coding and discover 

projects created by local tinkerers. 


SHEFFIELD RASPBERRY JAM 

When: Thursday 15 March 

Where: Hertha Ayrton STEM Centre, 
Sheffield, UK 

magpi.cc/2ExT89z 

If you’ve built an interesting Pi 

project, bring it along and share it 

with the community for the chance 

to win an exciting prize. 
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PATRIOT PI JAM 

When: Saturday 17 March 

Where: Cherry Valley-Springfield 
Central School District, 
Cherry Valley, NY, USA 

magpi.cc/2ED5MUy 

Celebrate making with the Raspberry 

Pi at CV-S’s first ever Jam. Come 

empty-handed or bring your own Pi. 


YORK PI JAM FOR BEGINNERS 

When: Saturday 24 March 

Where: Robert Wilkinson Primary 
Academy, West End, York, UK 

magpi.cc/2spChAL 

A Raspberry Pi Jam for beginners, 

allowing them to learn more about 

the Raspberry Pi at this family- 

friendly event. 
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YORK PI JAM FOR 
BEGINNERS 


SHEFFIELD 
RASPBERRY JAM 


6, 
‘ 0 
Of 
8 


RASPBERRY JAM 


LONDON 
RASPBERRY PINT 


REGULAR EVENTS 


PRESTON RASPBERRY JAM 

When: Monday 5 February 

Where: Media Factory Building, 
Preston, UK 

magpi.cc/2EDfNBk 

A community of people who meet 

in Preston each month to learn, 

create, and share the potential of 

the Raspberry Pi. 


LONDON RASPBERRY PINT 
When: Tuesday 27 March 

Where: CodeNode, London, UK 
magpi.cc/2swMPhN 

Got a Raspberry Pi project 
you’re working on? Show it 

off or get advice from others 

at Raspberry Pint, one of a 
number of capital events. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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BIGBIRTHDAY .,,.,.< 
WEEKEND Pee iay 


Raspberry Pi turns six this year and 

to celebrate this, the Raspberry Pi 

Foundation is co-ordinating a huge 
number of Jams around the world 

to participate in the Big Birthday 
Weekend. There are over 100 Jams 
co-ordinating events on Saturday 

3 March (and a few on Sunday 4 
March). You can read more about them 
- including an up-to-date list! - in This 
Month in Raspberry Pi, on page 88. 
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European Astro Pi Challenge 
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LETTERS 


BIRTHDAY PARTY 


I’m excited to be attending a 
Big Birthday Weekend Jam near 
me in March - I’ve not been 
able to come to the last two 
Cambridge-based 


It’s great you’ve managed to finda 
local Jam to go to! The Big Birthday 
Weekend has been a great way to 
get people to come together and 
celebrate the Raspberry Pi without 


birthday parties, having to travel 
so I’m happy that ~*R A S p B E R R to Cambridge 
this year I’ll be Y and try to get 
able to celebrate one of the 
the birthday of limited tickets. 
Raspberry Pi with That being said, 
other people! ‘there will bea big, 
I was just official event in 
wondering, ; Cambridge held by 
though, will 4 Raspberry Pi this 
there be a normal \! summer. We don’t 
birthday party like the have many details 


last two years? I’ve not seen 
any info on it. I loved looking 

at the pictures of the last one 
and hearing about the cool stuff 
that went on. Either way, happy 
birthday to the Raspberry Pi! 
Beth 


I’ve recently been getting into 
wearables, making little light- 
up badges and patterns on old 
clothes I had. It’s been really 
fun, but I wanted to expand what 
I did with wearables. Would the 
Raspberry Pi be suitable for this? 
What Raspberry Pi would be best 
for a wearable, do you think? 
Lee 


We’ve successfully used the 
Raspberry Pi for wearables in the 
past — even as far as using it for 
complex cosplay electronics! As 
the Raspberry Pi is nice and easy to 
program, with plenty of tutorials 
online on how to hook up 


on it yet, other than it will be 

the weekend of 30 June — 1 July. 
Hopefully it means the weather 
will be a bit better! We'll definitely 
try to get there as well, so you’ ll 
have another chance to meet 

The MagPi team. 


electronics to it, it can be quite 
quick to set up your own custom 
wearable using one. 

Other wearable makers and 
cosplayers may warn that the 
Raspberry Pi can draw a bit more 
power than other microcontrollers 
like Arduino. However, we’ve never 
experienced a problem with not 
having enough power to last fora 
significant amount of time. 

As for what Raspberry Pi model 
we recommend ~ the Pi Zero is the 
natural choice for wearables due 
to its size. However, if you have 
the space, an A+ or even a full-size 
Raspberry Pi 3 will do the trick as 
they’re still very small. 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving 
for the community — join in via 
raspberrypi.org/forums 


he piece on making a text adventure in : 

The MagPi #64 reminded me of the game The sim ple way to mount your Pi! 

‘Hampstead’ on the ZX Spectrum. What 
makes that game stick in my mind is that it isa 
satirical game about social climbing (a typically - Industrial DIN rail mount 
British hang-up). Hampstead is an expensive : 
London suburb. But in this game you can’t just * Open frame for better airflow 
go to Hampstead and buy a house there: you e Integ rated USB strain relief 
have to ‘attain Hampstead’. This you accomplish 
— as far as I remember — by marrying the boss’s 
daughter, among other things. 

I bring this up to illustrate the point that 

it is not the sophistication of the technology 
that makes a game immortal (or we wouldn't 
mess with retro games), but the wit of the 
game’s designers. 


geoffreymh 


We fully agree — while games are generally more 
complex these days due to advancements in both 
the technology we play them on and the ease 
with which games can be developed, a good story 
and a good idea is timeless, whether it’s a simple 
text adventure, a ZX Spectrum game with limited 
colours, or a full-on VR experience. 

Hopefully, the tutorial from issue 64 will show 
people just how simple they can start with game 
making, and work from there to make their 
magnum opus, whatever form it might take. 
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START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


“We use Code Club's fun educational resources to runa 
weekly after-school club for Year 7 and Year 8 pupils. The 
students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


wa Code Club is free 


4 Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


Ku Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us! 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 eS 


IN ASSOCIATION WITH: 


PROJECTS 


“This project lets you build an image-recognition Learn more: 
device that can see and identify objects, powered : ; aa 
by TensorFlow’s machine learning models.” alyprojects.withgoogle.com 


cardboard kit from that enables 
you to build an intelligent camera. 

10 lucky winners will get a complete 

AIY Projects Vision Kit. 


P é (et =e 
is the amazing y < 
: 


VisionBonnet accessory board 
24mm RGB arcade button 
and nut 

Privacy LED 

Piezo buzzer 

Cardboard box and frame 


Put everything together in the kit 
to build an intelligent camera 


Terms & Conditions 


Competition opens on 21 February 2018 and closes on 29 March 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the 


Raspberry Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering 
the competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and 


no cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WoRD 


mpowering young people with technology 
is a big part of what we do at the Raspberry 
Pi Foundation. In order to do that, we make 
computers as affordable as we possibly can. We also 
train educators for free and provide free content for 
them to teach digital making during the school day. 

However, providing the opportunity for young 
people to learn about computers after school and on 
weekends is just as critical. They can use technology 
to explore their interests and passions, whether 
that’s solving a problem, making a game, expressing 
themselves creatively, or just having fun. 

This is why the Raspberry Pi Foundation supports 
Code Club and CoderDojo. Both programs take 


and we need your help 


place outside of school time and provide young 
people with the opportunity to explore and create 
with technology. 

Code Clubs are for 9- to 13-year-olds and typically 
take place once a week for an hour at school, but after 
the end of the school day. We provide educators the 
content, structure, and volunteer matching so that their 
students can learn computational thinking with Scratch, 
make games or websites, and have fun at the same time. 

A Dojo is for 7- to 17-year-olds and takes place in 
the evenings or on the weekends. They’re typically 
hosted at community centres, libraries, universities, 
and corporate offices. CoderDojo is an opportunity 
for young people to create their own projects with 
technology with the help of volunteer mentors. 
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We want this movement to be 
accessible to all young people 


MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


KING AN 
IMPACT OUTSIDE 
THE CLASSROOM 


cf A growing after-school movement provides more opportunities 
: for young people to learn tech. Matt Richardson explains 


Youth can create games, phone apps, websites, 
or even dip into physical computing. 

An important aspect of these after-school 
programs is that they’re an opportunity for the youth 
to learn in a self-directed manner. They can zip 
ahead or take it at an easy pace. If there’s something 
they want to experiment with or get creative with, 
they can take a detour. 


Different reasons 

A young person may have different motivations 

for being at a Code Club or Dojo. Some may want to 
develop solutions to address real-world problems 

in their home or community. Some may want to 
create games; others to use code 

to express themselves creatively. 
What’s important is that the youth 
are doing something they want to 
do, and not something that they’re 
assigned to do. 

Unlike in the classroom, a club isn’t 
rigorous environment. There are no tests, reports, 

or papers. It’s an opportunity to create, learn, 
collaborate, and share without pressure. I know from 
my own personal experience that not all youth thrive 
in the classroom, but can really shine in a more 
informal environment where they can explore their 
own passions. 

We want this movement to be accessible to all 
young people and we need your help to make that 
happen. You can attend a local club with your kids, 
volunteer as a mentor, or encourage your local school 
or library to start one up. You can even start your own 
club for your community. Let’s work together to put 
the power and potential of digital making into the 
hands of all young people, all over the world. 
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THE Official 
RASPBERRY PI 
EGINNER'S BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adaptors 

8GB Micro SD card 

116-page beginner’s book 


RASPBERRY PI 
The pocket-sized desktop computer! _— 
i 


store.rpipress.cc 


Cana 


— 


5 aT a a aes ee 


Ce 


Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 
Power Supply and HDM} cable 
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Available in Europe 
Available for worldwide shipping at: through RS Components 


$389” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi Is a registered trademark of the Raspberry Pi Foundation, 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license, RS logo Is 

a registered trademark of RS Components Ltd, Canakit is a registered 
trademark of Cana Kit Corporation, 
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